View Javadoc

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  }