/*
* 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.controller;
import static org.jboss.as.controller.descriptions.ModelDescriptionConstants.FAILURE_DESCRIPTION;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import org.jboss.as.controller.descriptions.ModelDescriptionConstants;
import org.jboss.as.controller.descriptions.common.ControllerResolver;
import org.jboss.as.controller.logging.ControllerLogger;
import org.jboss.as.controller.operations.MultistepUtil;
import org.jboss.dmr.ModelNode;
import org.jboss.dmr.ModelType;
/**
* Handler for the "composite" operation; i.e. one that includes one or more child operations
* as steps.
*
* @author <a href="mailto:david.lloyd@redhat.com">David M. Lloyd</a>
* @author Brian Stansberry (c) 2011 Red Hat Inc.
*/
public class CompositeOperationHandler implements OperationStepHandler {
@Deprecated
public static final OperationContext.AttachmentKey<Boolean> DOMAIN_EXECUTION_KEY = OperationContext.AttachmentKey.create(Boolean.class);
public static final CompositeOperationHandler INSTANCE = new CompositeOperationHandler();
public static final String NAME = ModelDescriptionConstants.COMPOSITE;
/** Gets the failure message used for reporting a rollback with no failure message in a step */
public static String getUnexplainedFailureMessage() {
return ControllerLogger.ROOT_LOGGER.compositeOperationRolledBack();
}
private static final AttributeDefinition STEPS = new PrimitiveListAttributeDefinition.Builder(ModelDescriptionConstants.STEPS, ModelType.OBJECT)
.build();
public static final OperationDefinition DEFINITION = new SimpleOperationDefinitionBuilder(NAME, ControllerResolver.getResolver("root"))
.addParameter(STEPS)
.setReplyType(ModelType.OBJECT)
.setReplyValueType(ModelType.OBJECT)
.build();
public static final OperationDefinition INTERNAL_DEFINITION = new SimpleOperationDefinitionBuilder(NAME, ControllerResolver.getResolver("root"))
.addParameter(STEPS)
.setReplyType(ModelType.OBJECT)
.setPrivateEntry() // even if we eventually remove this from the non-internal definition, keep it here
//.setForceDefaultDescriptionProvider()// this one we don't display description even if operation is private
.build();
protected CompositeOperationHandler() {
}
public final void execute(final OperationContext context, final ModelNode operation) throws OperationFailedException {
STEPS.validateOperation(operation);
final ModelNode responseMap = context.getResult().setEmptyObject();
// Add a step to the OC for each element in the "steps" param.
final List<ModelNode> list = operation.get(ModelDescriptionConstants.STEPS).asList();
Map<String, ModelNode> operationMap = new LinkedHashMap<>();
final Map<String, ModelNode> addedResponses = new LinkedHashMap<>();
final int size = list.size();
for (int i = 0; i < size; i++) {
String stepName = "step-" + (i+1);
operationMap.put(stepName, list.get(i));
// This makes the result steps appear in the correct order
ModelNode stepResp = responseMap.get(stepName);
addedResponses.put(stepName, stepResp);
}
boolean adjustStepAddresses = context.getCurrentAddress().size() > 0;
MultistepUtil.recordOperationSteps(context, operationMap, addedResponses, getOperationHandlerResolver(), adjustStepAddresses);
context.completeStep(new OperationContext.RollbackHandler() {
@Override
public void handleRollback(OperationContext context, ModelNode operation) {
// don't override useful failure information in the domain
// or any existing failure message
if (context.getAttachment(DOMAIN_EXECUTION_KEY) != null || context.hasFailureDescription()) {
return;
}
final ModelNode failureMsg = new ModelNode();
for (int i = 0; i < size; i++) {
String stepName = "step-" + (i+1);
ModelNode stepResponse = responseMap.get(stepName);
if (stepResponse.hasDefined(FAILURE_DESCRIPTION)) {
failureMsg.get(ControllerLogger.ROOT_LOGGER.compositeOperationFailed(), ControllerLogger.ROOT_LOGGER.operation(stepName)).set(stepResponse.get(FAILURE_DESCRIPTION));
}
}
if (!failureMsg.isDefined()) {
failureMsg.set(getUnexplainedFailureMessage());
}
context.getFailureDescription().set(failureMsg);
}
});
}
protected MultistepUtil.OperationHandlerResolver getOperationHandlerResolver() {
return MultistepUtil.OperationHandlerResolver.DEFAULT;
}
}