/*
* $Id: MuleContextInitialisePhase.java 20321 2010-11-24 15:21:24Z dfeist $
* --------------------------------------------------------------------------------------
* Copyright (c) MuleSoft, Inc. All rights reserved. http://www.mulesoft.com
*
* The software in this package is published under the terms of the CPAL v1.0
* license, a copy of which has been included with this distribution in the
* LICENSE.txt file.
*/
package org.mule.lifecycle.phases;
import org.mule.api.agent.Agent;
import org.mule.api.component.Component;
import org.mule.api.construct.FlowConstruct;
import org.mule.api.lifecycle.Disposable;
import org.mule.api.lifecycle.Initialisable;
import org.mule.api.lifecycle.LifecycleException;
import org.mule.api.model.Model;
import org.mule.api.routing.OutboundRouter;
import org.mule.api.routing.OutboundRouterCollection;
import org.mule.api.source.MessageSource;
import org.mule.api.transport.Connector;
import org.mule.config.i18n.CoreMessages;
import org.mule.lifecycle.LifecycleObject;
import org.mule.lifecycle.NotificationLifecycleObject;
import org.mule.util.annotation.AnnotationMetaData;
import org.mule.util.annotation.AnnotationUtils;
import java.lang.reflect.Method;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Set;
import javax.annotation.PostConstruct;
/**
* The MuleContextInitialisePhase defines the lifecycle behaviour when the Mule context is initialised. The MuleContext is associated
* with one or more registries that inherit the lifecycle of the MuleContext.
* <p/>
* This phase is responsible for initialising objects. Any object that implements {@link org.mule.api.lifecycle.Initialisable} will
* have its {@link org.mule.api.lifecycle.Initialisable#initialise()} method called. Objects are initialised in the order based on type:
* {@link org.mule.api.transport.Connector}, {@link org.mule.api.agent.Agent}, {@link org.mule.api.model.Model}, {@link org.mule.api.service.Service}, followed
* by any other object that implements {@link org.mule.api.lifecycle.Initialisable}.
*
* @see org.mule.api.MuleContext
* @see org.mule.api.lifecycle.LifecycleManager
* @see org.mule.api.lifecycle.Initialisable
* @since 3.0
*/
public class MuleContextInitialisePhase extends DefaultLifecyclePhase
{
public MuleContextInitialisePhase()
{
super(Initialisable.PHASE_NAME, Initialisable.class, Disposable.PHASE_NAME);
registerSupportedPhase(NotInLifecyclePhase.PHASE_NAME);
Set<LifecycleObject> startOrderedObjects = new LinkedHashSet<LifecycleObject>();
startOrderedObjects.add(new NotificationLifecycleObject(Connector.class));
startOrderedObjects.add(new NotificationLifecycleObject(Agent.class));
startOrderedObjects.add(new NotificationLifecycleObject(Model.class));
startOrderedObjects.add(new NotificationLifecycleObject(FlowConstruct.class));
startOrderedObjects.add(new NotificationLifecycleObject(Initialisable.class));
setOrderedLifecycleObjects(startOrderedObjects);
setIgnoredObjectTypes(new Class[]{Component.class, MessageSource.class, OutboundRouterCollection.class, OutboundRouter.class});
}
@Override
public void applyLifecycle(Object o) throws LifecycleException
{
//retain default Lifecycle behaviour
super.applyLifecycle(o);
if (o == null)
{
return;
}
if (ignoreType(o.getClass()))
{
return;
}
//Lets check for {@link PostConstruct} annotations on methods of this object and invoke
List<AnnotationMetaData> annos = AnnotationUtils.getMethodAnnotations(o.getClass(), PostConstruct.class);
//Note that the registry has a processor that validates that there is at most one {@link PostConstruct} annotation
//per object and that the method conforms to a lifecycle method
if (annos.size() == 1)
{
AnnotationMetaData anno = annos.get(0);
try
{
((Method) anno.getMember()).invoke(o);
}
catch (Exception e)
{
throw new LifecycleException(CoreMessages.failedToInvokeLifecycle(anno.getMember().getName(), o), e, this);
}
}
}
}