/* * 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; } }