1 /* 2 * $Id: Initialisable.java 7963 2007-08-21 08:53:15Z dirk.olmes $ 3 * -------------------------------------------------------------------------------------- 4 * Copyright (c) MuleSource, Inc. All rights reserved. http://www.mulesource.com 5 * 6 * The software in this package is published under the terms of the CPAL v1.0 7 * license, a copy of which has been included with this distribution in the 8 * LICENSE.txt file. 9 */ 10 11 package org.mule.umo.lifecycle; 12 13 /** 14 * <code>Initialisable</code> is a lifecycle interface that gets called at the 15 * initialise lifecycle stage of the implementing component. 16 */ 17 public interface Initialisable 18 { 19 /** 20 * Method used to perform any initialisation work. If a fatal error occurs during 21 * initialisation an <code>InitialisationException</code> should be thrown, 22 * causing the Mule instance to shutdown. If the error is recoverable, say by 23 * retrying to connect, a <code>RecoverableException</code> should be thrown. 24 * There is no guarantee that by throwing a Recoverable exception that the Mule 25 * instance will not shut down. 26 * 27 * @throws InitialisationException if a fatal error occurs causing the Mule 28 * instance to shutdown 29 * @throws RecoverableException if an error occurs that can be recovered from 30 */ 31 void initialise() throws InitialisationException; 32 }