package rose;

import com.linar.jintegra.*;

/**
 * COM Class 'RosePathMap'. Generated 1/31/00 1:50:06 PM
 * from 'C:\Program Files\Rational\Rose 2000\rationalrose.tlb'<P>
 * Generated using version 1.3.1  of <B>J-Integra[tm]</B> -- pure Java/COM integration technology from Linar Ltd.
 * See  <A HREF="http://www.linar.com/">http://www.linar.com/</A><P>
 */
public class RosePathMap implements com.linar.jintegra.RemoteObjRef, IRosePathMap {

  private static final String CLSID = "97b38395-a4e3-11d0-bff0-00aa003def5b";

  protected String getJintegraVersion() { return "1.3.1"; }

  // Interface delagates
  private IRosePathMapProxy d_IRosePathMapProxy = null;

  /** Compare this object with another */
  public boolean equals(Object o) { return d_IRosePathMapProxy == null ? false : d_IRosePathMapProxy.equals(o); }

   /**
   * getActiveObject. Get a reference to a running instance of this class on the current machine using native code.
   *                  <B>Uses native code (See GetActiveObject() in MS doc) and thus can only be used on MS Windows</B>
   *
   * @return    return value.  A reference to the running object.
   * @exception java.io.IOException If there are communications problems.
   * @exception com.linar.jintegra.AutomationException If there was an error attaching to the instance.
   */
  public static RosePathMap getActiveObject() throws com.linar.jintegra.AutomationException, java.io.IOException {
    return new RosePathMap(com.linar.jintegra.Dispatch.getActiveObject(CLSID));
  }

  /**
   * bindUsingMoniker. Bind to a running instance of this class using the supplied ObjRef moniker
   *
   * @return    return value.  A reference to the running object.
   * @param     moniker. The ObjRef Moniker (Created using Windows CreateObjrefMoniker() and IMoniker->GetDisplayName)
   * @exception java.io.IOException If there are communications problems.
   * @exception com.linar.jintegra.AutomationException If there was an error attaching to the instance.
   */
  public static RosePathMap bindUsingMoniker(String moniker) throws com.linar.jintegra.AutomationException, java.io.IOException {
    return new RosePathMap(com.linar.jintegra.Dispatch.bindUsingMoniker(moniker));
  }

  /** J-Integra internal method */
  public com.linar.jintegra.Dispatch getJintegraDispatch() { return d_IRosePathMapProxy; }

  /**
   * Constructs a RosePathMap on the local host.
   * @exception java.io.IOException if there are problems communicating via DCOM 
   * @exception java.net.UnknownHostException if the host can not be found 
   */
  public RosePathMap() throws java.io.IOException, java.net.UnknownHostException {
    this("localhost", null);
  }

  /**
   * Construct a RosePathMap on specified host.
   * @param     host  the host on which the object should be created
   * @exception java.io.IOException if there are problems communicating via DCOM 
   * @exception java.net.UnknownHostException if the host can not be found 
   */
  public RosePathMap(String host) throws java.io.IOException, java.net.UnknownHostException {
    this(host, null);
  }

  /**
   * @deprecated use AuthInfo.setDefault(...) or AuthInfo.setThreadDefault(...)
   * See Security section in the J-Integra documentation
   * @see com.linar.jintegra.AuthInfo.setDefault(..)
   */
  public RosePathMap(AuthInfo authInfo) throws java.io.IOException, java.net.UnknownHostException {
    this("localhost", authInfo);
  }

  /**
   * @deprecated use AuthInfo.setDefault(...) or AuthInfo.setThreadDefault(...)
   * See Security section in the J-Integra documentation
   * @see com.linar.jintegra.AuthInfo.setDefault(..)
   */
  public RosePathMap(String host, AuthInfo authInfo) throws java.io.IOException, java.net.UnknownHostException {
    d_IRosePathMapProxy = new IRosePathMapProxy(CLSID, host, authInfo);
  }

  /**
   * Construct a RosePathMap using a reference to such an object returned from a COM server
   * @param     obj an object returned from a COM server
   * @exception java.io.IOException if there are problems communicating via DCOM 
   */
  public RosePathMap(Object obj) throws java.io.IOException {
    d_IRosePathMapProxy = new IRosePathMapProxy(obj);
  }

  /**
   * Release a RosePathMap.
   */
  public void release() {
    com.linar.jintegra.Cleaner.release(d_IRosePathMapProxy);
  }

  /**
   * getPropertyByName. Get the value of a property dynamically at run-time, based on its name
   *
   * @return    return value.  The value of the property.
   * @param     name. The name of the property to get.
   * @exception java.lang.NoSuchFieldException If the property does not exit.
   * @exception java.io.IOException If there are communications problems.
   * @exception com.linar.jintegra.AutomationException If the remote server throws an exception.
   */
  public Object getPropertyByName(String name) throws NoSuchFieldException, java.io.IOException, com.linar.jintegra.AutomationException {
    try {
      return d_IRosePathMapProxy.getPropertyByName(name);
    } catch(com.linar.jintegra.AutomationException automationException) {
      automationException.fillInStackTrace();
      throw automationException;
    } catch(NoSuchFieldException noSuchFieldException) {
      noSuchFieldException.fillInStackTrace();
      throw noSuchFieldException;
    }
  }

  /**
   * getPropertyByName. Get the value of a property dynamically at run-time, based on its name and a parameter
   *
   * @return    return value.  The value of the property.
   * @param     name. The name of the property to get.
   * @param     rhs. A parameter used when getting the proxy
   * @exception java.lang.NoSuchFieldException If the property does not exit.
   * @exception java.io.IOException If there are communications problems.
   * @exception com.linar.jintegra.AutomationException If the remote server throws an exception.
   */
  public Object getPropertyByName(String name, Object rhs) throws NoSuchFieldException, java.io.IOException, com.linar.jintegra.AutomationException {
    try {
      return d_IRosePathMapProxy.getPropertyByName(name, rhs);
    } catch(com.linar.jintegra.AutomationException automationException) {
      automationException.fillInStackTrace();
      throw automationException;
    } catch(NoSuchFieldException noSuchFieldException) {
      noSuchFieldException.fillInStackTrace();
      throw noSuchFieldException;
    }
  }

  /**
   * invokeMethodByName. Invoke a method dynamically at run-time
   *
   * @return    return value.  The value returned by the method (null if none).
   * @param     name. The name of the method to be invoked
   * @param     parameters.  One element for each parameter.  Use primitive type wrappers
   *            to pass primitive types (eg Integer to pass an int).
   * @exception java.lang.NoSuchMethodException If the method does not exit.
   * @exception java.io.IOException If there are communications problems.
   * @exception com.linar.jintegra.AutomationException If the remote server throws an exception.
   */
  public Object invokeMethodByName(String name, Object[] parameters) throws NoSuchMethodException, java.io.IOException, com.linar.jintegra.AutomationException {
    return d_IRosePathMapProxy.invokeMethodByName(name, parameters);
  }

  /**
   * deleteEntry. 
   *
   * @param     Symbol The Symbol (in)
   * @return    return value.  The return value
   * @exception java.io.IOException If there are communications problems.
   * @exception com.linar.jintegra.AutomationException If the remote server throws an exception.
   */
  public boolean deleteEntry  (
              String Symbol) throws java.io.IOException, com.linar.jintegra.AutomationException {
    try {
      return d_IRosePathMapProxy.deleteEntry(Symbol);
    } catch(com.linar.jintegra.AutomationException automationException) {
      automationException.fillInStackTrace();
      throw automationException;
    }
  }

  /**
   * getActualPath. 
   *
   * @param     VirtualPath The VirtualPath (in)
   * @return    return value.  The return value
   * @exception java.io.IOException If there are communications problems.
   * @exception com.linar.jintegra.AutomationException If the remote server throws an exception.
   */
  public String getActualPath  (
              String VirtualPath) throws java.io.IOException, com.linar.jintegra.AutomationException {
    try {
      return d_IRosePathMapProxy.getActualPath(VirtualPath);
    } catch(com.linar.jintegra.AutomationException automationException) {
      automationException.fillInStackTrace();
      throw automationException;
    }
  }

  /**
   * getVirtualPath. 
   *
   * @param     ActualPath The ActualPath (in)
   * @return    return value.  The return value
   * @exception java.io.IOException If there are communications problems.
   * @exception com.linar.jintegra.AutomationException If the remote server throws an exception.
   */
  public String getVirtualPath  (
              String ActualPath) throws java.io.IOException, com.linar.jintegra.AutomationException {
    try {
      return d_IRosePathMapProxy.getVirtualPath(ActualPath);
    } catch(com.linar.jintegra.AutomationException automationException) {
      automationException.fillInStackTrace();
      throw automationException;
    }
  }

  /**
   * hasEntry. 
   *
   * @param     Symbol The Symbol (in)
   * @return    return value.  The return value
   * @exception java.io.IOException If there are communications problems.
   * @exception com.linar.jintegra.AutomationException If the remote server throws an exception.
   */
  public boolean hasEntry  (
              String Symbol) throws java.io.IOException, com.linar.jintegra.AutomationException {
    try {
      return d_IRosePathMapProxy.hasEntry(Symbol);
    } catch(com.linar.jintegra.AutomationException automationException) {
      automationException.fillInStackTrace();
      throw automationException;
    }
  }

  /**
   * addEntry. 
   *
   * @param     Symbol The Symbol (in)
   * @param     Path The Path (in)
   * @param     Comment The Comment (in)
   * @return    return value.  The return value
   * @exception java.io.IOException If there are communications problems.
   * @exception com.linar.jintegra.AutomationException If the remote server throws an exception.
   */
  public boolean addEntry  (
              String Symbol,
              String Path,
              String Comment) throws java.io.IOException, com.linar.jintegra.AutomationException {
    try {
      return d_IRosePathMapProxy.addEntry(Symbol,Path,Comment);
    } catch(com.linar.jintegra.AutomationException automationException) {
      automationException.fillInStackTrace();
      throw automationException;
    }
  }

  /**
   * getActualPathWithContext. 
   *
   * @param     VirtualPath The VirtualPath (in)
   * @param     Context The Context (in)
   * @return    return value.  The return value
   * @exception java.io.IOException If there are communications problems.
   * @exception com.linar.jintegra.AutomationException If the remote server throws an exception.
   */
  public String getActualPathWithContext  (
              String VirtualPath,
              String Context) throws java.io.IOException, com.linar.jintegra.AutomationException {
    try {
      return d_IRosePathMapProxy.getActualPathWithContext(VirtualPath,Context);
    } catch(com.linar.jintegra.AutomationException automationException) {
      automationException.fillInStackTrace();
      throw automationException;
    }
  }

  /**
   * getVirtualPathWithContext. 
   *
   * @param     ActualPath The ActualPath (in)
   * @param     Context The Context (in)
   * @return    return value.  The return value
   * @exception java.io.IOException If there are communications problems.
   * @exception com.linar.jintegra.AutomationException If the remote server throws an exception.
   */
  public String getVirtualPathWithContext  (
              String ActualPath,
              String Context) throws java.io.IOException, com.linar.jintegra.AutomationException {
    try {
      return d_IRosePathMapProxy.getVirtualPathWithContext(ActualPath,Context);
    } catch(com.linar.jintegra.AutomationException automationException) {
      automationException.fillInStackTrace();
      throw automationException;
    }
  }

}
