libsidl-dev 1.4.0.dfsg-8build3 / usr / include / cxx / sidl_Finder.hxx

// 
// File:          sidl_Finder.hxx
// Symbol:        sidl.Finder-v0.9.17
// Symbol Type:   interface
// Babel Version: 1.4.0 (Revision: 6607 release-1-4-0-branch)
// Release:       $Name:  $
// Revision:      @(#) $Id: $
// Description:   Client-side glue code for sidl.Finder
// 
// Copyright (c) 2000-2002, Lawrence Livermore National Security, LLC.
// Produced at the Lawrence Livermore National Laboratory.
// Written by the Components Team <components@llnl.gov>
// All rights reserved.
// 
// This file is part of Babel. For more information, see
// http://www.llnl.gov/CASC/components/. Please read the COPYRIGHT file
// for Our Notice and the LICENSE file for the GNU Lesser General Public
// License.
// 
// This program is free software; you can redistribute it and/or modify it
// under the terms of the GNU Lesser General Public License (as published by
// the Free Software Foundation) version 2.1 dated February 1999.
// 
// This program 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 terms and
// conditions of the GNU Lesser General Public License for more details.
// 
// You should have recieved a copy of the GNU Lesser General Public License
// along with this program; if not, write to the Free Software Foundation,
// Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
// 
// WARNING: Automatically generated; changes will be lost
// 
// 

#ifndef included_sidl_Finder_hxx
#define included_sidl_Finder_hxx

#ifndef included_sidl_cxx_hxx
#include "sidl_cxx.hxx"
#endif
// declare class before main #includes
// (this alleviates circular #include guard problems)[BUG#393]
namespace sidl { 

  class Finder;
} // end namespace sidl

// Some compilers need to define array template before the specializations
namespace sidl {
  template<>
  class array< ::sidl::Finder >;
}
// 
// Forward declarations for method dependencies.
// 
namespace sidl { 

  class DLL;
} // end namespace sidl

namespace sidl { 

  class RuntimeException;
} // end namespace sidl

#ifndef included_sidl_cxx_hxx
#include "sidl_cxx.hxx"
#endif
#ifndef included_sidl_Finder_IOR_h
#include "sidl_Finder_IOR.h"
#endif
#ifndef included_sidl_BaseInterface_hxx
#include "sidl_BaseInterface.hxx"
#endif
#ifndef included_sidl_Resolve_hxx
#include "sidl_Resolve.hxx"
#endif
#ifndef included_sidl_Scope_hxx
#include "sidl_Scope.hxx"
#endif
namespace sidl {
  namespace rmi {
    class Call;
    class Return;
    class Ticket;
  }
  namespace rmi {
    class InstanceHandle;
  }
}
namespace sidl { 

  /**
   * Symbol "sidl.Finder" (version 0.9.17)
   * 
   * Interface <code>Finder</code> is an interface for classes that resolve 
   * dynamic libraries.  
   * Class <code>Loader</code> takes one of these interfaces through the 
   * method <code>setFinder</code>.  If NULL is passed to setFinder, the 
   * class <code>DefaultFinder</code> is used.
   */
  class Finder: public virtual ::sidl::BaseInterface {

    //////////////////////////////////////////////////
    // 
    // Special methods for throwing exceptions
    // 

  private:
    static 
    void
    throwException0(
      const char* methodName,
      struct sidl_BaseInterface__object *_exception
    )
      // throws:
    ;

    //////////////////////////////////////////////////
    // 
    // User Defined Methods
    // 

  public:

    /**
     * Find a DLL containing the specified information for a sidl
     * class. This method searches through the files in set set path
     * looking for a shared library that contains the client-side or IOR
     * for a particular sidl class.
     * 
     * @param sidl_name  the fully qualified (long) name of the
     * class/interface to be found. Package names
     * are separated by period characters from each
     * other and the class/interface name.
     * @param target     to find a client-side binding, this is
     * normally the name of the language.
     * To find the implementation of a class
     * in order to make one, you should pass
     * the string "ior/impl" here.
     * @param lScope     this specifies whether the symbols should
     * be loaded into the global scope, a local
     * scope, or use the setting in the file.
     * @param lResolve   this specifies whether symbols should be
     * resolved as needed (LAZY), completely
     * resolved at load time (NOW), or use the
     * setting from the file.
     * @return a non-NULL object means the search was successful.
     * The DLL has already been added.
     */
    ::sidl::DLL
    findLibrary (
      /* in */const ::std::string& sidl_name,
      /* in */const ::std::string& target,
      /* in */::sidl::Scope lScope,
      /* in */::sidl::Resolve lResolve
    )
    ;



    /**
     * Set the search path, which is a semi-colon separated sequence of
     * URIs as described in class <code>DLL</code>.  This method will
     * invalidate any existing search path.
     */
    void
    setSearchPath (
      /* in */const ::std::string& path_name
    )
    ;



    /**
     * Return the current search path.  If the search path has not been
     * set, then the search path will be taken from environment variable
     * SIDL_DLL_PATH.
     */
    ::std::string
    getSearchPath() ;


    /**
     * Append the specified path fragment to the beginning of the
     * current search path.  If the search path has not yet been set
     * by a call to <code>setSearchPath</code>, then this fragment will
     * be appended to the path in environment variable SIDL_DLL_PATH.
     */
    void
    addSearchPath (
      /* in */const ::std::string& path_fragment
    )
    ;



    //////////////////////////////////////////////////
    // 
    // End User Defined Methods
    // (everything else in this file is specific to
    //  Babel's C++ bindings)
    // 

  public:
    typedef struct sidl_Finder__object ior_t;
    typedef struct sidl_Finder__external ext_t;
    typedef struct sidl_Finder__sepv sepv_t;

    // default constructor
    Finder()  : sidl_Finder_IORCache((ior_t*) NULL){ }

#ifdef WITH_RMI

    // RMI connect
    static inline ::sidl::Finder _connect( /*in*/ const std::string& url ) { 
      return _connect(url, true);
    }

    // RMI connect 2
    static ::sidl::Finder _connect( /*in*/ const std::string& url, /*in*/ const 
      bool ar  );


#endif /*WITH_RMI*/

    // default destructor
    virtual ~Finder () { }

    // copy constructor
    Finder ( const Finder& original );

    // assignment operator
    Finder& operator= ( const Finder& rhs );

    // conversion from ior to C++ class
    Finder ( Finder::ior_t* ior );

    // Alternate constructor: does not call addRef()
    // (sets d_weak_reference=isWeak)
    // For internal use by Impls (fixes bug#275)
    Finder ( Finder::ior_t* ior, bool isWeak );

    inline ior_t* _get_ior() const throw() {
      if(!sidl_Finder_IORCache) { 
        sidl_Finder_IORCache = ::sidl::Finder::_cast((void*)d_self);
        if (sidl_Finder_IORCache) {
          struct sidl_BaseInterface__object *throwaway_exception;
          (sidl_Finder_IORCache->d_epv->f_deleteRef)(
            sidl_Finder_IORCache->d_object, &throwaway_exception);  
        }  
      }
      return sidl_Finder_IORCache;
    }

    inline void _set_ior( ior_t* ptr ) throw () { 
      d_self = reinterpret_cast< void*>(ptr);
      sidl_Finder_IORCache = (ior_t*) ptr;

    }

    virtual int _set_ior_typesafe( struct sidl_BaseInterface__object *obj,
                                   const ::std::type_info &argtype );

    bool _is_nil() const throw () { return (d_self==0); }

    bool _not_nil() const throw () { return (d_self!=0); }

    bool operator !() const throw () { return (d_self==0); }

    static inline const char * type_name() throw () { return "sidl.Finder";}

    static struct sidl_Finder__object* _cast(const void* src);

    // execute member function by name
    void _exec(const std::string& methodName,
               ::sidl::rmi::Call& inArgs,
               ::sidl::rmi::Return& outArgs);

    /**
     * Get the URL of the Implementation of this object (for RMI)
     */
    ::std::string
    _getURL() // throws:
    //    ::sidl::RuntimeException
    ;


    /**
     * Method to enable/disable method hooks invocation.
     */
    void
    _set_hooks (
      /* in */bool enable
    )
    // throws:
    //    ::sidl::RuntimeException
    ;


    /**
     * Method to enable/disable interface contract enforcement.
     */
    void
    _set_contracts (
      /* in */bool enable,
      /* in */const ::std::string& enfFilename,
      /* in */bool resetCounters
    )
    // throws:
    //    ::sidl::RuntimeException
    ;


    /**
     * Method to dump contract enforcement statistics.
     */
    void
    _dump_stats (
      /* in */const ::std::string& filename,
      /* in */const ::std::string& prefix
    )
    // throws:
    //    ::sidl::RuntimeException
    ;

    // return true iff object is remote
    bool _isRemote() const { 
      ior_t* self = const_cast<ior_t*>(_get_ior() );
      struct sidl_BaseInterface__object *throwaway_exception;
      return (*self->d_epv->f__isRemote)(self, &throwaway_exception) == TRUE;
    }

    // return true iff object is local
    bool _isLocal() const {
      return !_isRemote();
    }

  protected:
    // Pointer to external (DLL loadable) symbols (shared among instances)
    static const ext_t * s_ext;

  public:
    static const ext_t * _get_ext() throw ( ::sidl::NullIORException );


    //////////////////////////////////////////////////
    // 
    // Locally Cached IOR pointer
    // 

  protected:
    mutable ior_t* sidl_Finder_IORCache;
  }; // end class Finder
} // end namespace sidl

extern "C" {


#pragma weak sidl_Finder__connectI

  /**
   * RMI connector function for the class. (no addref)
   */
  struct sidl_Finder__object*
  sidl_Finder__connectI(const char * url, sidl_bool ar, struct 
    sidl_BaseInterface__object **_ex);


} // end extern "C"
namespace sidl {
  // traits specialization
  template<>
  struct array_traits< ::sidl::Finder > {
    typedef array< ::sidl::Finder > cxx_array_t;
    typedef ::sidl::Finder cxx_item_t;
    typedef struct sidl_Finder__array ior_array_t;
    typedef sidl_interface__array ior_array_internal_t;
    typedef struct sidl_Finder__object ior_item_t;
    typedef cxx_item_t value_type;
    typedef value_type reference;
    typedef value_type* pointer;
    typedef const value_type const_reference;
    typedef const value_type* const_pointer;
    typedef array_iter< array_traits< ::sidl::Finder > > iterator;
    typedef const_array_iter< array_traits< ::sidl::Finder > > const_iterator;
  };

  // array specialization
  template<>
  class array< ::sidl::Finder >: public interface_array< array_traits< 
    ::sidl::Finder > > {
  public:
    typedef interface_array< array_traits< ::sidl::Finder > > Base;
    typedef array_traits< ::sidl::Finder >::cxx_array_t          cxx_array_t;
    typedef array_traits< ::sidl::Finder >::cxx_item_t           cxx_item_t;
    typedef array_traits< ::sidl::Finder >::ior_array_t          ior_array_t;
    typedef array_traits< ::sidl::Finder >::ior_array_internal_t 
      ior_array_internal_t;
    typedef array_traits< ::sidl::Finder >::ior_item_t           ior_item_t;

    /**
     * conversion from ior to C++ class
     * (constructor/casting operator)
     */
    array( struct sidl_Finder__array* src = 0) : Base(src) {}

    /**
     * copy constructor
     */
    array( const array< ::sidl::Finder >&src) : Base(src) {}

    /**
     * assignment
     */
    array< ::sidl::Finder >&
    operator =( const array< ::sidl::Finder >&rhs ) { 
      if (d_array != rhs._get_baseior()) {
        if (d_array) deleteRef();
        d_array = const_cast<sidl__array *>(rhs._get_baseior());
        if (d_array) addRef();
      }
      return *this;
    }

  };
}

#ifndef included_sidl_DLL_hxx
#include "sidl_DLL.hxx"
#endif
#endif