/*
* JBoss, Home of Professional Open Source.
* Copyright 2011, Red Hat, Inc., and individual contributors
* as indicated by the @author tags. See the copyright.txt file in the
* distribution for a full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.as.messaging;
import static org.jboss.as.controller.SimpleAttributeDefinitionBuilder.create;
import static org.jboss.as.controller.descriptions.ModelDescriptionConstants.OP;
import static org.jboss.as.controller.descriptions.ModelDescriptionConstants.READ_ATTRIBUTE_OPERATION;
import static org.jboss.as.messaging.HornetQActivationService.rollbackOperationIfServerNotActive;
import static org.jboss.as.messaging.ManagementUtil.reportListOfStrings;
import static org.jboss.as.messaging.ManagementUtil.reportRoles;
import static org.jboss.as.messaging.ManagementUtil.reportRolesAsJSON;
import static org.jboss.as.messaging.OperationDefinitionHelper.createNonEmptyStringAttribute;
import static org.jboss.as.messaging.OperationDefinitionHelper.runtimeOnlyOperation;
import static org.jboss.as.messaging.OperationDefinitionHelper.runtimeReadOnlyOperation;
import static org.jboss.dmr.ModelType.BOOLEAN;
import static org.jboss.dmr.ModelType.LIST;
import static org.jboss.dmr.ModelType.STRING;
import org.hornetq.api.core.management.HornetQServerControl;
import org.hornetq.core.server.HornetQServer;
import org.jboss.as.controller.AbstractRuntimeOnlyHandler;
import org.jboss.as.controller.AttributeDefinition;
import org.jboss.as.controller.OperationContext;
import org.jboss.as.controller.OperationFailedException;
import org.jboss.as.controller.PathAddress;
import org.jboss.as.controller.SimpleAttributeDefinition;
import org.jboss.as.controller.SimpleAttributeDefinitionBuilder;
import org.jboss.as.controller.descriptions.ModelDescriptionConstants;
import org.jboss.as.controller.descriptions.ResourceDescriptionResolver;
import org.jboss.as.controller.operations.validation.StringLengthValidator;
import org.jboss.as.controller.registry.AttributeAccess;
import org.jboss.as.controller.registry.ManagementResourceRegistration;
import org.jboss.as.messaging.logging.MessagingLogger;
import org.jboss.dmr.ModelNode;
import org.jboss.dmr.ModelType;
import org.jboss.msc.service.ServiceController;
import org.jboss.msc.service.ServiceName;
/**
* Handles operations and attribute reads supported by a HornetQ {@link org.hornetq.api.core.management.HornetQServerControl}.
*
* @author Brian Stansberry (c) 2011 Red Hat Inc.
*/
public class HornetQServerControlHandler extends AbstractRuntimeOnlyHandler {
static final HornetQServerControlHandler INSTANCE = new HornetQServerControlHandler();
public static final AttributeDefinition ACTIVE = create("active", BOOLEAN)
.setStorageRuntime()
.build();
public static final AttributeDefinition STARTED = new SimpleAttributeDefinition(CommonAttributes.STARTED, ModelType.BOOLEAN,
false, AttributeAccess.Flag.STORAGE_RUNTIME);
public static final AttributeDefinition VERSION = new SimpleAttributeDefinition(CommonAttributes.VERSION, ModelType.STRING,
false, AttributeAccess.Flag.STORAGE_RUNTIME);
private static final AttributeDefinition[] ATTRIBUTES = { STARTED, VERSION, ACTIVE };
public static final String GET_CONNECTORS_AS_JSON = "get-connectors-as-json";
// public static final String ENABLE_MESSAGE_COUNTERS = "enable-message-counters";
// public static final String DISABLE_MESSAGE_COUNTERS = "disable-message-counters";
public static final String RESET_ALL_MESSAGE_COUNTERS = "reset-all-message-counters";
public static final String RESET_ALL_MESSAGE_COUNTER_HISTORIES = "reset-all-message-counter-histories";
public static final String LIST_PREPARED_TRANSACTIONS = "list-prepared-transactions";
public static final String LIST_PREPARED_TRANSACTION_DETAILS_AS_JSON = "list-prepared-transaction-details-as-json";
public static final String LIST_PREPARED_TRANSACTION_DETAILS_AS_HTML = "list-prepared-transaction-details-as-html";
public static final String LIST_HEURISTIC_COMMITTED_TRANSACTIONS = "list-heuristic-committed-transactions";
public static final String LIST_HEURISTIC_ROLLED_BACK_TRANSACTIONS = "list-heuristic-rolled-back-transactions";
public static final String COMMIT_PREPARED_TRANSACTION = "commit-prepared-transaction";
public static final String ROLLBACK_PREPARED_TRANSACTION = "rollback-prepared-transaction";
public static final String LIST_REMOTE_ADDRESSES = "list-remote-addresses";
public static final String CLOSE_CONNECTIONS_FOR_ADDRESS = "close-connections-for-address";
public static final String CLOSE_CONNECTIONS_FOR_USER = "close-connections-for-user";
public static final String CLOSE_CONSUMER_CONNECTIONS_FOR_ADDRESS= "close-consumer-connections-for-address";
public static final String LIST_CONNECTION_IDS= "list-connection-ids";
public static final String LIST_PRODUCERS_INFO_AS_JSON = "list-producers-info-as-json";
public static final String LIST_SESSIONS = "list-sessions";
public static final String GET_ROLES = "get-roles";
// we keep the operation for backwards compatibility but it duplicates the "get-roles" operation
// (except it returns a String instead of a List)
@Deprecated
public static final String GET_ROLES_AS_JSON = "get-roles-as-json";
public static final String GET_ADDRESS_SETTINGS_AS_JSON = "get-address-settings-as-json";
public static final String FORCE_FAILOVER = "force-failover";
// enableMessageCounters(maybe), disableMessageCounters(maybe), resetAllMessageCounters,
// resetAllMessageCounterHistories, listPreparedTransactions,
// listPreparedTransactionDetailsAsJSON, listPreparedTransactionDetailsAsHTML, listHeuristicCommittedTransactions
// listHeuristicRolledBackTransactions, commitPreparedTransaction, rollbackPreparedTransaction,
// listRemoteAddresses, listRemoteAddresses(String), closeConnectionsForAddress, listConnectionIDs,
// listProducersInfoAsJSON, listSessions, getRoles, getRolesAsJSON, getAddressSettingsAsJSON,
// forceFailover
public static final String HQ_SERVER = "hornetq-server";
public static final AttributeDefinition TRANSACTION_AS_BASE_64 = createNonEmptyStringAttribute("transaction-as-base-64");
public static final AttributeDefinition ADDRESS_MATCH = createNonEmptyStringAttribute("address-match");
public static final AttributeDefinition USER = createNonEmptyStringAttribute("user");
public static final AttributeDefinition CONNECTION_ID = createNonEmptyStringAttribute("connection-id");
public static final AttributeDefinition REQUIRED_IP_ADDRESS = createNonEmptyStringAttribute("ip-address");
public static final AttributeDefinition OPTIONAL_IP_ADDRESS = SimpleAttributeDefinitionBuilder.create("ip-address", ModelType.STRING)
.setAllowNull(true)
.setValidator(new StringLengthValidator(1, Integer.MAX_VALUE, true, false))
.build();
private HornetQServerControlHandler() {
}
@Override
protected void executeRuntimeStep(OperationContext context, ModelNode operation) throws OperationFailedException {
final String operationName = operation.require(OP).asString();
final ServiceName hqServiceName = MessagingServices.getHornetQServiceName(PathAddress.pathAddress(operation.get(ModelDescriptionConstants.OP_ADDR)));
ServiceController<?> hqService = context.getServiceRegistry(false).getService(hqServiceName);
if (hqService == null || hqService.getState() != ServiceController.State.UP) {
throw MessagingLogger.ROOT_LOGGER.hornetQServerNotInstalled(hqServiceName.getSimpleName());
}
HornetQServer hqServer = HornetQServer.class.cast(hqService.getValue());
if (READ_ATTRIBUTE_OPERATION.equals(operationName)) {
handleReadAttribute(context, operation, hqServer);
context.stepCompleted();
return;
}
if (rollbackOperationIfServerNotActive(context, operation)) {
return;
}
final HornetQServerControl serverControl = getServerControl(context, operation);
try {
if (GET_CONNECTORS_AS_JSON.equals(operationName)) {
String json = serverControl.getConnectorsAsJSON();
context.getResult().set(json);
} else if (RESET_ALL_MESSAGE_COUNTERS.equals(operationName)) {
serverControl.resetAllMessageCounters();
context.getResult();
} else if (RESET_ALL_MESSAGE_COUNTER_HISTORIES.equals(operationName)) {
serverControl.resetAllMessageCounterHistories();
context.getResult();
} else if (LIST_PREPARED_TRANSACTIONS.equals(operationName)) {
String[] list = serverControl.listPreparedTransactions();
reportListOfStrings(context, list);
} else if (LIST_PREPARED_TRANSACTION_DETAILS_AS_JSON.equals(operationName)) {
String json = serverControl.listPreparedTransactionDetailsAsJSON();
context.getResult().set(json);
} else if (LIST_PREPARED_TRANSACTION_DETAILS_AS_HTML.equals(operationName)) {
String html = serverControl.listPreparedTransactionDetailsAsHTML();
context.getResult().set(html);
} else if (LIST_HEURISTIC_COMMITTED_TRANSACTIONS.equals(operationName)) {
String[] list = serverControl.listHeuristicCommittedTransactions();
reportListOfStrings(context, list);
} else if (LIST_HEURISTIC_ROLLED_BACK_TRANSACTIONS.equals(operationName)) {
String[] list = serverControl.listHeuristicRolledBackTransactions();
reportListOfStrings(context, list);
} else if (COMMIT_PREPARED_TRANSACTION.equals(operationName)) {
String txId = TRANSACTION_AS_BASE_64.resolveModelAttribute(context, operation).asString();
boolean committed = serverControl.commitPreparedTransaction(txId);
context.getResult().set(committed);
} else if (ROLLBACK_PREPARED_TRANSACTION.equals(operationName)) {
String txId = TRANSACTION_AS_BASE_64.resolveModelAttribute(context, operation).asString();
boolean committed = serverControl.rollbackPreparedTransaction(txId);
context.getResult().set(committed);
} else if (LIST_REMOTE_ADDRESSES.equals(operationName)) {
ModelNode address = OPTIONAL_IP_ADDRESS.resolveModelAttribute(context, operation);
String[] list = address.isDefined() ? serverControl.listRemoteAddresses(address.asString()) : serverControl.listRemoteAddresses();
reportListOfStrings(context, list);
} else if (CLOSE_CONNECTIONS_FOR_ADDRESS.equals(operationName)) {
String address = REQUIRED_IP_ADDRESS.resolveModelAttribute(context, operation).asString();
boolean closed = serverControl.closeConnectionsForAddress(address);
context.getResult().set(closed);
} else if (CLOSE_CONNECTIONS_FOR_USER.equals(operationName)) {
String user = USER.resolveModelAttribute(context, operation).asString();
boolean closed = serverControl.closeConnectionsForUser(user);
context.getResult().set(closed);
} else if (CLOSE_CONSUMER_CONNECTIONS_FOR_ADDRESS.equals(operationName)) {
String address = ADDRESS_MATCH.resolveModelAttribute(context, operation).asString();
boolean closed = serverControl.closeConsumerConnectionsForAddress(address);
context.getResult().set(closed);
} else if (LIST_CONNECTION_IDS.equals(operationName)) {
String[] list = serverControl.listConnectionIDs();
reportListOfStrings(context, list);
} else if (LIST_PRODUCERS_INFO_AS_JSON.equals(operationName)) {
String json = serverControl.listProducersInfoAsJSON();
context.getResult().set(json);
} else if (LIST_SESSIONS.equals(operationName)) {
String connectionID = CONNECTION_ID.resolveModelAttribute(context, operation).asString();
String[] list = serverControl.listSessions(connectionID);
reportListOfStrings(context, list);
} else if (GET_ROLES.equals(operationName)) {
String addressMatch = ADDRESS_MATCH.resolveModelAttribute(context, operation).asString();
String json = serverControl.getRolesAsJSON(addressMatch);
reportRoles(context, json);
} else if (GET_ROLES_AS_JSON.equals(operationName)) {
String addressMatch = ADDRESS_MATCH.resolveModelAttribute(context, operation).asString();
String json = serverControl.getRolesAsJSON(addressMatch);
reportRolesAsJSON(context, json);
} else if (GET_ADDRESS_SETTINGS_AS_JSON.equals(operationName)) {
String addressMatch = ADDRESS_MATCH.resolveModelAttribute(context, operation).asString();
String json = serverControl.getAddressSettingsAsJSON(addressMatch);
context.getResult().set(json);
} else if (FORCE_FAILOVER.equals(operationName)) {
serverControl.forceFailover();
context.getResult();
} else {
// Bug
throw MessagingLogger.ROOT_LOGGER.unsupportedOperation(operationName);
}
} catch (RuntimeException e) {
throw e;
} catch (Exception e) {
context.getFailureDescription().set(e.getLocalizedMessage());
}
context.stepCompleted();
}
public void registerAttributes(final ManagementResourceRegistration registry) {
for (AttributeDefinition attr : ATTRIBUTES) {
registry.registerReadOnlyAttribute(attr, this);
}
}
public void registerOperations(final ManagementResourceRegistration registry, ResourceDescriptionResolver resolver) {
registry.registerOperationHandler(runtimeReadOnlyOperation(GET_CONNECTORS_AS_JSON, resolver)
.setReplyType(STRING)
.build(),
this);
registry.registerOperationHandler(runtimeOnlyOperation(RESET_ALL_MESSAGE_COUNTERS, resolver)
.build(),
this);
registry.registerOperationHandler(runtimeOnlyOperation(RESET_ALL_MESSAGE_COUNTER_HISTORIES, resolver)
.build(),
this);
registry.registerOperationHandler(runtimeReadOnlyOperation(LIST_PREPARED_TRANSACTIONS, resolver)
.setReplyType(LIST)
.setReplyValueType(STRING)
.build(),
this);
registry.registerOperationHandler(runtimeReadOnlyOperation(LIST_PREPARED_TRANSACTION_DETAILS_AS_JSON, resolver)
.setReplyType(STRING)
.build(),
this);
registry.registerOperationHandler(runtimeReadOnlyOperation(LIST_PREPARED_TRANSACTION_DETAILS_AS_HTML, resolver)
.setReplyType(STRING)
.build(),
this);
registry.registerOperationHandler(runtimeReadOnlyOperation(LIST_HEURISTIC_COMMITTED_TRANSACTIONS, resolver)
.setReplyType(LIST)
.setReplyValueType(STRING)
.build(),
this);
registry.registerOperationHandler(runtimeReadOnlyOperation(LIST_HEURISTIC_ROLLED_BACK_TRANSACTIONS, resolver)
.setReplyType(LIST)
.setReplyValueType(STRING)
.build(),
this);
registry.registerOperationHandler(runtimeOnlyOperation(COMMIT_PREPARED_TRANSACTION, resolver)
.setParameters(TRANSACTION_AS_BASE_64)
.setReplyType(BOOLEAN)
.build(),
this);
registry.registerOperationHandler(runtimeOnlyOperation(ROLLBACK_PREPARED_TRANSACTION, resolver)
.setParameters(TRANSACTION_AS_BASE_64)
.setReplyType(BOOLEAN)
.build(),
this);
registry.registerOperationHandler(runtimeReadOnlyOperation(LIST_REMOTE_ADDRESSES, resolver)
.setParameters(OPTIONAL_IP_ADDRESS)
.setReplyType(LIST)
.setReplyValueType(STRING)
.build(),
this);
registry.registerOperationHandler(runtimeOnlyOperation(CLOSE_CONNECTIONS_FOR_ADDRESS, resolver)
.setParameters(REQUIRED_IP_ADDRESS)
.setReplyType(BOOLEAN)
.build(),
this);
registry.registerOperationHandler(runtimeOnlyOperation(CLOSE_CONNECTIONS_FOR_USER, resolver)
.setParameters(USER)
.setReplyType(BOOLEAN)
.build(),
this);
registry.registerOperationHandler(runtimeOnlyOperation(CLOSE_CONSUMER_CONNECTIONS_FOR_ADDRESS, resolver)
.setParameters(ADDRESS_MATCH)
.setReplyType(BOOLEAN)
.build(),
this);
registry.registerOperationHandler(runtimeReadOnlyOperation(LIST_CONNECTION_IDS, resolver)
.setReplyType(LIST)
.setReplyValueType(STRING)
.build(),
this);
registry.registerOperationHandler(runtimeReadOnlyOperation(LIST_PRODUCERS_INFO_AS_JSON, resolver)
.setReplyType(STRING)
.build(),
this);
registry.registerOperationHandler(runtimeReadOnlyOperation(LIST_SESSIONS, resolver)
.setParameters(CONNECTION_ID)
.setReplyType(LIST)
.setReplyValueType(STRING)
.build(),
this);
registry.registerOperationHandler(runtimeReadOnlyOperation(GET_ROLES_AS_JSON, resolver)
.setParameters(ADDRESS_MATCH)
.setReplyType(STRING)
.build(),
this);
registry.registerOperationHandler(runtimeReadOnlyOperation(GET_ADDRESS_SETTINGS_AS_JSON, resolver)
.setParameters(ADDRESS_MATCH)
.setReplyType(STRING)
.build(),
this);
registry.registerOperationHandler(runtimeOnlyOperation(FORCE_FAILOVER, resolver)
.build(),
this);
registry.registerOperationHandler(runtimeReadOnlyOperation(GET_ROLES, resolver)
.setParameters(ADDRESS_MATCH)
.setReplyType(LIST)
.setReplyParameters(SecurityRoleDefinition.NAME,
SecurityRoleDefinition.SEND,
SecurityRoleDefinition.CONSUME,
SecurityRoleDefinition.CREATE_DURABLE_QUEUE,
SecurityRoleDefinition.DELETE_DURABLE_QUEUE,
SecurityRoleDefinition.CREATE_NON_DURABLE_QUEUE,
SecurityRoleDefinition.DELETE_NON_DURABLE_QUEUE,
SecurityRoleDefinition.MANAGE)
.build(),
this);
}
private void handleReadAttribute(OperationContext context, ModelNode operation, final HornetQServer server) throws OperationFailedException {
final String name = operation.require(ModelDescriptionConstants.NAME).asString();
if (STARTED.getName().equals(name)) {
boolean started = server.isStarted();
context.getResult().set(started);
} else if (VERSION.getName().equals(name)) {
String version = server.getVersion().getFullVersion();
context.getResult().set(version);
} else if (ACTIVE.getName().equals(name)) {
boolean active = server.isActive();
context.getResult().set(active);
} else {
// Bug
throw MessagingLogger.ROOT_LOGGER.unsupportedAttribute(name);
}
}
private HornetQServerControl getServerControl(final OperationContext context, ModelNode operation) throws OperationFailedException {
final ServiceName hqServiceName = MessagingServices.getHornetQServiceName(PathAddress.pathAddress(operation.get(ModelDescriptionConstants.OP_ADDR)));
ServiceController<?> hqService = context.getServiceRegistry(false).getService(hqServiceName);
if (hqService == null || hqService.getState() != ServiceController.State.UP) {
throw MessagingLogger.ROOT_LOGGER.hornetQServerNotInstalled(hqServiceName.getSimpleName());
}
HornetQServer hqServer = HornetQServer.class.cast(hqService.getValue());
return hqServer.getHornetQServerControl();
}
}