cvs commit: jakarta-avalon-apps/enterprise/corbaloc/src/idl corbaloc.idl

[mc...@apache.org]

mcconnell    2002/09/06 23:55:01

  Added:       enterprise/corbaloc/src/idl corbaloc.idl
  Log:
  Defintion of a remotely accessible service resolver.
  
  Revision  Changes    Path
  1.1                  jakarta-avalon-apps/enterprise/corbaloc/src/idl/corbaloc.idl
  
  Index: corbaloc.idl
  ===================================================================
  //
  // hello.idl
  //
  // Created on 13 February 2002
  // by Stephen McConnell <mc...@apache.org>
  //
  
  #ifndef _CORBALOC_IDL_
  #define _CORBALOC_IDL_
  #pragma prefix "orb.apache.org"
  
  module corbaloc
  {
  
     /**
      * Exception indicating the referral of the request to an 
      * alternative URL.
      */
      exception ServiceRedirection
      {
         /**
          * The path representing the external form of a redirection URL.
          */
          string path;
      };
  
     /**
      * Exception raised in response to an invalid query applied to 
      * a <code>Finder</code> implementation.
      */
      exception InvalidQuery
      {
         /**
          * The inital query.
          */
          string query;
  
         /**
          * A message detailing the cause of the invalid status.
          */
          string message;
      };
  
     /**
      * Exception raised in response to a request for a reference resolution
      * that cannot be fulfilled by a <code>Chooser</code> implementation.
      */
      exception UnknownReference
      {
         /**
          * The inital ref value.
          */
          string reference;
  
         /**
          * A message detailing the cause of the invalid status.
          */
          string message;
  
      };
  
     /**
      * Exception raised in response to a request for a reference resolution
      * that cannot be fulfilled due to an invalid reference value.
      */
      exception InvalidReference
      {
         /**
          * The inital ref value.
          */
          string reference;
  
         /**
          * A message detailing the cause of the invalid status.
          */
          string message;
      };
  
     /**
      * An abstract interface implemented by objects capable of handling
      * URL based queries.  A service resolver handles resolution of URL 
      * fragments that are unresolved relative to a corbaloc service 
      * registration.  Fragement URI elements not covered by the CORBA 
      * corbaloc specificiation including extended path arguments, query 
      * and URI fragments (commonly refered to as ref elements).
      */
      abstract interface Resolver
      {
         /**
          * Locates a CORBA Object based on a supplied url.
          * 
          * @param uri the uresolved uri
          * @return the result of path resolution
          * @exception InvalidQuery if the uri is invalid
          * @exception ServiceRedirection if the uri request is being redirected
          * @exception InvalidReference if the reference is invalid
          * @exception UnknownReference if the reference is unknown
          */
          Object resolve( in string uri ) raises ( 
            InvalidQuery, UnknownReference, InvalidReference, ServiceRedirection );
      };
  
  
     /**
      * The ServiceResolver interface defines a corbaloc resolvable resource capable 
      * of handling unresolved corbaloc fragments.
      */
      interface ServiceResolver : Resolver
      {
      };
  
  };
  
  #endif // _CORBALOC_IDL_
  
  
  

--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>