cimclient.java

Pegasus is an open-source implementationof the DMTF CIM and WBEM standards. It is designed to be por

//%2006////////////////////////////////////////////////////////////////////////
//
// Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development
// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.;
// IBM Corp.; EMC Corporation, The Open Group.
// Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.;
// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.
// Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.;
// EMC Corporation; VERITAS Software Corporation; The Open Group.
// Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.;
// EMC Corporation; Symantec Corporation; The Open Group.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to
// deal in the Software without restriction, including without limitation the
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
// sell copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//
//==============================================================================
//
// Author:      Adrian Schuur, [e-mail]
//
// Modified By: Mark Hamzy, [e-mail]
//
//%/////////////////////////////////////////////////////////////////////////////
package org.pegasus.jmpi;

import java.util.*;
import org.pegasus.jmpi.*;

public class CIMClient
{
    public static final String  WQL  = "WQL";
    public static final String  WQL1 = "WQL1";
    public static final String  WQL2 = "WQL2";
    public static final int     HTTP = 2;
    public static final int     XML  = 2;
    public static final boolean DEEP = true;

    private CIMNameSpace ns;
    private long         cInst;
    private long         cNsInst;

    private native long   _newNaUnPw              (long          name,
                                                   String        userName,
                                                   String        passWord);

    private native void   _disconnect             (long          cc);
    private native long   _getClass               (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   boolean       localOnly,
                                                   boolean       includeQualifiers,
                                                   boolean       includeClassOrigin,
                                                   String        propertyList[]);
    private native void   _deleteClass            (long          cc,
                                                   long          ns,
                                                   long          path);
    private native void   _createClass            (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   long          ci);
    private native void   _setClass               (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   long          ci);

    private native long   _getInstance            (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   boolean       localOnly,
                                                   boolean       includeQualifiers,
                                                   boolean       includeClassOrigin,
                                                   String        propertyList[]);
    private native void   _deleteInstance         (long          cc,
                                                   long          ns,
                                                   long          path);
    private native long   _createInstance         (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   long          ci);
    private native void   _modifyInstance         (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   long          ci,
                                                   boolean       includeQualifiers,
                                                   String        propertyList[]);

    private native long   _enumerateClasses       (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   boolean       deep,
                                                   boolean       localOnly,
                                                   boolean       includeQualifiers,
                                                   boolean       includeClassOrigin);
    private native long   _enumerateClassNames    (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   boolean       deep);
    private native long   _enumerateInstanceNames (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   boolean       deep);
    private native long   _enumerateInstances     (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   boolean       deep,
                                                   boolean       localOnly,
                                                   boolean       includeQualifiers,
                                                   boolean       includeClassOrigin,
                                                   String        propertyList[]);
    private native long   _enumerateQualifiers    (long          cc,
                                                   long          ns,
                                                   long          path);

    private native long   _getQualifier           (long          cc,
                                                   long          ns,
                                                   long          path);
    private native void   _setQualifier           (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   long          type);
    private native void   _deleteQualifier        (long          cc,
                                                   long          ns,
                                                   long          path);

    private native long   _getProperty            (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   String        propertyName);
    private native void   _setProperty            (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   String        propertyName,
                                                   long          newValue);

    private native long   _execQuery              (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   String        query,
                                                   String        ql);

    private native long   _invokeMethod           (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   String        methodName,
                                                   Vector        inParams,
                                                   Vector        outParams)
          throws CIMException;
    private native long   _invokeMethod24         (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   String        methodName,
                                                   CIMArgument[] inParams,
                                                   CIMArgument[] outParams)
          throws CIMException;

    private native long   _associatorNames        (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   String        assocClass,
                                                   String        resultClass,
                                                   String        role,
                                                   String        resultRole);
    private native long   _associators            (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   String        assocClass,
                                                   String        resultClass,
                                                   String        role,
                                                   String        resultRole,
                                                   boolean       includeQualifiers,
                                                   boolean       includeClassOrigin,
                                                   String        propertyList[]);
    private native long   _referenceNames         (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   String        resultClass,
                                                   String        role);
    private native long   _references             (long          cc,
                                                   long          ns,
                                                   long          path,
                                                   String        resultClass,
                                                   String        role,
                                                   boolean       includeQualifiers,
                                                   boolean       includeClassOrigin,
                                                   String        propertyList[]);

    private native void   _createNameSpace        (long          cc,
                                                   String        ns);
    private native Vector _enumerateNameSpaces    (long          cc,
                                                   long          path,
                                                   boolean       deep,
                                                   Vector        v);
    private native void   _deleteNameSpace        (long          cc,
                                                   String        ns);

    private native void   _finalize               (long          cInst);

    protected void finalize ()
    {
        _finalize (cInst);
    }

    protected long cInst ()
    {
        return cInst;
    }

    public CIMNameSpace getNameSpace ()
    {
        return ns;
    }

    public CIMClient(CIMNameSpace nameSpace,
                     String       userName,
                     String       pword)
         throws CIMException
    {
        ns      = nameSpace;
        cNsInst = nameSpace.cInst ();
        cInst   = _newNaUnPw (cNsInst, userName, pword);
    }

    public CIMClient (CIMNameSpace nameSpace,
                      String       userName,
                      String       pword,
                      long         type)
         throws CIMException
    {
        if (type != HTTP)
            throw new CIMException ("Specified protocol type not supported.");

        ns      = nameSpace;
        cNsInst = nameSpace.cInst ();
        cInst   = _newNaUnPw (cNsInst, userName, pword);
    }
/*
    public CIMClient (CIMNameSpace name,
                      String       userName,
                      String       pword,
                      String       roleName,
                      String       rolePwd)
         throws CIMException
    {
    }

    public CIMClient (CIMNameSpace name,
                      String       userName,
                      String       pword,
                      String       roleName,
                      String       rolePwd,
                      long         type)
         throws CIMException
    {
    }
*/

    public void close ()
         throws CIMException
    {
       if (cInst != 0)
       {
          _disconnect (cInst);
       }
    }

    public void createNameSpace (CIMNameSpace ins)
         throws CIMException
    {
       if (cInst != 0)
       {
          _createNameSpace (cInst, ins.getNameSpace ());
       }
    }

    public void deleteNameSpace (CIMNameSpace cns)
         throws CIMException
    {
       if (cInst != 0)
       {
          _deleteNameSpace (cInst, cns.getNameSpace ());
       }
    }

    public void deleteClass (CIMObjectPath path)
         throws CIMException
    {
       if (cInst != 0)
       {
          _deleteClass (cInst, cNsInst, path.cInst ());
       }
    }

    public void deleteInstance (CIMObjectPath path)
         throws CIMException
    {
       if (cInst != 0)
       {
          _deleteInstance (cInst, cNsInst, path.cInst ());
       }
    }

    public Enumeration enumNameSpace (CIMObjectPath path,
                                      boolean       deep)
         throws CIMException
    {
       Vector ret = new Vector ();

       if (cInst != 0)
       {
          _enumerateNameSpaces (cInst, path.cInst (), deep, ret);
       }

       return ret.elements();
    }

    public Enumeration enumerateNameSpaces (CIMObjectPath path,
                                            boolean       deepInheritance)
         throws CIMException
    {
       return enumNameSpace (path, deepInheritance);
    }

    public Enumeration enumClass (CIMObjectPath path,
                                  boolean       deep,
                                  boolean       local)
         throws CIMException
    {
       long ciEnumeration = 0;

       if (cInst != 0)
       {
          ciEnumeration = _enumerateClasses (cInst,
                                             cNsInst,
                                             path.cInst (),
                                             deep,
                                             local,
                                             true,