001/*
002 *  Licensed to the Apache Software Foundation (ASF) under one
003 *  or more contributor license agreements.  See the NOTICE file
004 *  distributed with this work for additional information
005 *  regarding copyright ownership.  The ASF licenses this file
006 *  to you under the Apache License, Version 2.0 (the
007 *  "License"); you may not use this file except in compliance
008 *  with the License.  You may obtain a copy of the License at
009 *
010 *        http://www.apache.org/licenses/LICENSE-2.0
011 *
012 *  Unless required by applicable law or agreed to in writing,
013 *  software distributed under the License is distributed on an
014 *  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
015 *  KIND, either express or implied.  See the License for the
016 *  specific language governing permissions and limitations
017 *  under the License.
018 */
019
020package org.apache.isis.core.commons.components;
021
022/**
023 * Indicate that the implementing component is scoped at application level
024 * (shared across multiple sessions) and might also require initialization or
025 * being shutdown.
026 * 
027 * <p>
028 * Analogous to Hibernate's <tt>SessionFactory</tt>.
029 * 
030 * @see SessionScopedComponent
031 * @see TransactionScopedComponent
032 */
033public interface ApplicationScopedComponent extends Component {
034
035    /**
036     * Indicates to the component that it is to initialise itself.
037     */
038    void init();
039
040    /**
041     * Indicates to the component that it will no longer be used and should shut
042     * itself down cleanly.
043     */
044    void shutdown();
045
046}