1. /*
  2. * @(#)Current.java 1.11 01/11/29
  3. *
  4. * Copyright 2002 Sun Microsystems, Inc. All rights reserved.
  5. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
  6. */
  7. package org.omg.CORBA;
  8. /**
  9. * An interface that makes it possible to access information
  10. * associated with a particular thread of execution, such as
  11. * security information or a transaction identifier.
  12. * <P>
  13. * An ORB or CORBA service that needs its own thread-specific
  14. * state extends the CORBA package's <code>Current</code>.
  15. * Users of the service can obtain an instance of the appropriate
  16. * <code>Current</code> interface by invoking
  17. * <code>ORB.resolve_initial_references</code>.
  18. * For example, the Security service obtains the <code>Current</code>
  19. * relevant to it by invoking
  20. * <PRE>
  21. * ORB.resolve_initial_references("SecurityCurrent");
  22. * </PRE>
  23. * <P>
  24. * A CORBA service does not have to use this method of keeping context
  25. * but may choose to do so.
  26. * <P>
  27. * Methods on classes that implement from <code>Current</code> access state
  28. * associated with the thread in which they are invoked, not state associated
  29. * with the thread from which the <code>Current</code> was obtained.
  30. * Current objects must not be exported to other processes, or externalized
  31. * with ORB.object_to_string. If any attempt is made to do so, the offending
  32. * operation will raise a MARSHAL system exception.
  33. * @see <a href="package-summary.html#unimpl"><code>portable</code>
  34. * package comments for unimplemented features</a>
  35. */
  36. public interface Current extends org.omg.CORBA.Object
  37. {
  38. }