001    /*
002     *  jDTAUS Core API
003     *  Copyright (c) 2005 Christian Schulte
004     *
005     *  Christian Schulte, Haldener Strasse 72, 58095 Hagen, Germany
006     *  <schulte2005@users.sourceforge.net> (+49 2331 3543887)
007     *
008     *  This library is free software; you can redistribute it and/or
009     *  modify it under the terms of the GNU Lesser General Public
010     *  License as published by the Free Software Foundation; either
011     *  version 2.1 of the License, or any later version.
012     *
013     *  This library is distributed in the hope that it will be useful,
014     *  but WITHOUT ANY WARRANTY; without even the implied warranty of
015     *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
016     *  Lesser General Public License for more details.
017     *
018     *  You should have received a copy of the GNU Lesser General Public
019     *  License along with this library; if not, write to the Free Software
020     *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
021     *
022     */
023    package org.jdtaus.core.container;
024    
025    /**
026     * Context initialization.
027     * <p>By implementing this interface implementations indicate that state may be
028     * bound to a client.</p>
029     *
030     * @author <a href="mailto:schulte2005@users.sourceforge.net">Christian Schulte</a>
031     * @version $Id: ContextInitializer.java 8044 2009-07-02 01:29:05Z schulte2005 $
032     * @deprecated Removed without replacement. An implementation's scope is
033     * specified by the specifications it implements.
034     */
035    public interface ContextInitializer
036    {
037        //--ContextInitializer------------------------------------------------------
038    
039        /**
040         * Checks if a context is initialized.
041         *
042         * @param ctx the context to check.
043         *
044         * @return {@code true} if {@code ctx} is initialized; {@code false} if not.
045         *
046         * @throws NullPointerException if {@code ctx} is {@code null}.
047         * @throws ContextError for unrecoverable context errors.
048         */
049        boolean isInitialized( Context ctx );
050    
051        /**
052         * Initializes a context.
053         *
054         * @param ctx the context to initialze.
055         *
056         * @throws NullPointerException if {@code ctx} is {@code null}.
057         * @throws ContextError for unrecoverable context errors.
058         */
059        void initialize( Context ctx );
060    
061        //------------------------------------------------------ContextInitializer--
062    }