duke@1: /* ohair@158: * Copyright (c) 1997, 2000, Oracle and/or its affiliates. All rights reserved. duke@1: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. duke@1: * duke@1: * This code is free software; you can redistribute it and/or modify it duke@1: * under the terms of the GNU General Public License version 2 only, as ohair@158: * published by the Free Software Foundation. Oracle designates this duke@1: * particular file as subject to the "Classpath" exception as provided ohair@158: * by Oracle in the LICENSE file that accompanied this code. duke@1: * duke@1: * This code is distributed in the hope that it will be useful, but WITHOUT duke@1: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or duke@1: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License duke@1: * version 2 for more details (a copy is included in the LICENSE file that duke@1: * accompanied this code). duke@1: * duke@1: * You should have received a copy of the GNU General Public License version duke@1: * 2 along with this work; if not, write to the Free Software Foundation, duke@1: * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. duke@1: * ohair@158: * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA ohair@158: * or visit www.oracle.com if you need additional information or have any ohair@158: * questions. duke@1: */ duke@1: duke@1: duke@1: // minimal definitions to keep idltojava happy while compiling poa.idl duke@1: #pragma prefix "omg.org" duke@1: duke@1: module CORBA { duke@1: duke@1: typedef string Identifier; duke@1: typedef string RepositoryId; duke@1: duke@1: // basic Policy definition duke@1: typedef unsigned long PolicyType ; duke@1: duke@1: /** The Policy interface provides a mechanism for ORBs and Object duke@1: * Services to allow access to certain choices that affect their duke@1: * operation. This information is accessed in a structured manner duke@1: * using interfaces derived from the org.omg.CORBA.Policy interface. duke@1: */ duke@1: interface Policy { duke@1: /** Return the constant value that corresponds to the duke@1: * type of the policy object. The values of duke@1: * the polivy objectys are allocated by the OMG. duke@1: * New values for PolicyType should be obtained from the OMG by duke@1: * sending mail to request@omg.org. In general the constant duke@1: * values that are allocated are defined in conjunction with duke@1: * the definition of the corresponding policy object. duke@1: * @return the constant value that corresponds to the type of duke@1: * the policy object. duke@1: */ duke@1: readonly attribute PolicyType policy_type; duke@1: duke@1: /** Copies the policy object. The copy does not retain any duke@1: * relationships that the policy had with any domain or object. duke@1: * @return the copy of the policy object. duke@1: */ duke@1: Policy copy( ); duke@1: duke@1: /** Destroys the policy object. It is the responsibility of duke@1: * the policy object to determine whether it can be destroyed. duke@1: */ duke@1: void destroy( ); duke@1: }; duke@1: duke@1: typedef sequence PolicyList; duke@1: duke@1: /** duke@1: * An interface that makes it possible to access information duke@1: * associated with a particular thread of execution, such as duke@1: * security information or a transaction identifier. duke@1: *

duke@1: * An ORB or CORBA service that needs its own thread-specific duke@1: * state extends the CORBA package's Current. duke@1: * Users of the service can obtain an instance of the appropriate duke@1: * Current interface by invoking duke@1: * ORB.resolve_initial_references. duke@1: * For example, the Security service obtains the Current duke@1: * relevant to it by invoking duke@1: * 

duke@1: 	 *    ORB.resolve_initial_references("SecurityCurrent");
duke@1: 	 *
duke@1: *

duke@1: * A CORBA service does not have to use this method of keeping context duke@1: * but may choose to do so. duke@1: *

duke@1: * Methods on classes that implement from Current access state duke@1: * associated with the thread in which they are invoked, not state associated duke@1: * with the thread from which the Current was obtained. duke@1: * Current objects must not be exported to other processes, or externalized duke@1: * with ORB.object_to_string. If any attempt is made to do so, the offending duke@1: * operation will raise a MARSHAL system exception. duke@1: * @see portable duke@1: * package comments for unimplemented features duke@1: */ duke@1: interface Current { }; duke@1: }; duke@1: duke@1: