Java example source code file (corba.idl)

This example Java source code file (corba.idl) is included in the alvinalexander.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" ^TM.

Learn more about this Java project at its project page.

Java - Java tags/keywords

corba, current, identifier, policy, policylist, policytype, repositoryid

The corba.idl Java example source code

/*
 * Copyright (c) 1997, 2000, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */


// minimal definitions to keep idltojava happy while compiling poa.idl
#pragma prefix "omg.org" 

module CORBA {   

	typedef string Identifier;
	typedef string RepositoryId;

        // basic Policy definition 
	typedef unsigned long PolicyType ;

	/** The Policy interface provides a mechanism for ORBs and Object
	* Services to allow access to certain choices that affect their 
	* operation.  This information is accessed in a structured manner
	* using interfaces derived from the org.omg.CORBA.Policy interface.
	*/
        interface Policy { 
		/** Return the constant value that corresponds to the 
		* type of the policy object.  The values of 
		* the polivy objectys are allocated by the OMG.
		* New values for PolicyType should be obtained from the OMG by
		* sending mail to request@omg.org.  In general the constant
		* values that are allocated are defined in conjunction with
		* the definition of the corresponding policy object.
		* @return the constant value that corresponds to the type of
		* the policy object.
		*/
		readonly attribute PolicyType policy_type;

		/** Copies the policy object. The copy does not retain any
		* relationships that the policy had with any domain or object.
		* @return the copy of the policy object.
		*/
                Policy copy( ); 

		/** Destroys the policy object.  It is the responsibility of
		* the policy object to determine whether it can be destroyed.
		*/
                void destroy( ); 
        }; 

        typedef sequence <Policy> PolicyList; 

	/**
	 * An interface that makes it possible to access information
	 * associated with a particular thread of execution, such as
	 * security information or a transaction identifier.
	 * <P>
	 * An ORB or CORBA service that needs its own thread-specific
	 * state extends the CORBA package's <code>Current.
	 * Users of the service can obtain an instance of the appropriate
	 * <code>Current interface by invoking
	 * <code>ORB.resolve_initial_references.
	 * For example, the Security service obtains the <code>Current
	 * relevant to it by invoking
	 * <PRE>
	 *    ORB.resolve_initial_references("SecurityCurrent");
	 * </PRE>
	 * <P>
	 * A CORBA service does not have to use this method of keeping context
	 * but may choose to do so.
	 * <P>
	 * Methods on classes that implement from <code>Current access state
	 * associated with the thread in which they are invoked, not state associated
	 * with the thread from which the <code>Current was obtained.
	 *  Current objects must not be exported to other processes, or externalized
	 *  with ORB.object_to_string. If any attempt is made to do so, the offending
	 *  operation will raise a MARSHAL system exception.
	 * @see <a href="package-summary.html#unimpl">portable
	 * package comments for unimplemented features</a>
	 */
        interface Current { };
};