Return to ObjectNormalizer.cpp CVS log

Up to [Pegasus] / pegasus / src / Pegasus / Common

PEP#: 141
TITLE:  Request/Response Validation

DESCRIPTION: Encapsulate uses of std with PEGASUS_STD. This approach
is used rather than a simple "using" statement because the output of this object
is temporary and will soon be converted to use the Pegasus trace and log components.

//%2003////////////////////////////////////////////////////////////////////////
//
// 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.
//
// 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: Chip Vincent (cvincent@us.ibm.com)
//
// Modified By:
//
//%/////////////////////////////////////////////////////////////////////////////

#include <Pegasus/Common/ObjectNormalizer.h>

PEGASUS_NAMESPACE_BEGIN

static CIMQualifier _resolveQualifier(
    const CIMQualifier & referenceQualifier,
    const CIMQualifier & cimQualifier)
{
    PEGASUS_STD(cout) << "_resolveQualifier(" << referenceQualifier.getName().getString() << ")" << PEGASUS_STD(endl);

    CIMName qualifierName = referenceQualifier.getName();
    CIMValue qualifierValue = referenceQualifier.getValue();
    CIMFlavor qualifierFlavor = referenceQualifier.getFlavor();
    Boolean propagated = referenceQualifier.getPropagated() == 0 ? false : true;

    CIMQualifier newQualifier(
        qualifierName,
        qualifierValue,
        qualifierFlavor,
        propagated);

    // apply default value
    if(cimQualifier.getValue().isNull() && !referenceQualifier.getValue().isNull())
    {
        newQualifier.setValue(referenceQualifier.getValue());
    }

    return(newQualifier);
}

static CIMProperty _resolveProperty(
    const CIMProperty & referenceProperty,
    const CIMProperty & cimProperty,
    const Boolean includeQualifiers,
    const Boolean includeClassOrigin)
{
    PEGASUS_STD(cout) << "_resolveProperty(" << referenceProperty.getName().getString() << ")" << PEGASUS_STD(endl);
    PEGASUS_STD(cout) << "flags :";
    PEGASUS_STD(cout) << " includeQualifiers = " << (includeQualifiers == true ? "true" : "false");
    PEGASUS_STD(cout) << " includeClassOrigin = " << (includeClassOrigin == true ? "true" : "false");
    PEGASUS_STD(cout) << PEGASUS_STD(endl);

    CIMName propertyName = referenceProperty.getName();
    CIMValue propertyValue = referenceProperty.getValue();
    Uint32 arraySize = referenceProperty.getArraySize();
    CIMName referenceClassName = referenceProperty.getReferenceClassName();
    CIMName classOrigin = referenceProperty.getClassOrigin();
    Boolean propagated = referenceProperty.getPropagated();

    // create "resolve" property
    CIMProperty newProperty(
        propertyName,
        propertyValue,
        arraySize,
        referenceClassName,
        classOrigin,
        propagated);

    // TODO: check type

    // TODO: check override (especially for references)?

    // apply default value
    if(cimProperty.getValue().isNull())
    {
        newProperty.setValue(referenceProperty.getValue());
    }

    // set class origin
    if(includeClassOrigin)
    {
        newProperty.setClassOrigin(referenceProperty.getClassOrigin());
    }
    else
    {
        // ATTN: this step should be unnecessary because the reference property should
        // have been gathered with the same flags, thus making this redundant. the current
        // repository does not seem to honor this flag.
        newProperty.setClassOrigin(CIMName());
    }

    // add qualifiers
    if(includeQualifiers)
    {
        // apply reference property qualifiers
        for(Uint32 i = 0, n = referenceProperty.getQualifierCount(); i < n;i++)
        {
            // ATTN: convert const qualifier to non const
            CIMQualifier referenceQualifier = referenceProperty.getQualifier(i).clone();

            PEGASUS_STD(cout) << "adding qualifier - " << referenceQualifier.getName().getString() << PEGASUS_STD(endl);

            newProperty.addQualifier(referenceQualifier);
        }

        // apply specified property qualifiers
        for(Uint32 i = 0, n = cimProperty.getQualifierCount(); i < n; i++)
        {
            Uint32 pos = newProperty.findQualifier(cimProperty.getQualifier(i).getName());

            if(pos == PEG_NOT_FOUND)
            {
                // ATTN: is it legal to specify qualifiers not in the property definition?
            }

            // get the recentyl add qualifier from the property
            CIMQualifier referenceQualifier = newProperty.getQualifier(pos);

            // ATTN: temporarily remove qualifier until a better way to update is implemented.
            newProperty.removeQualifier(pos);

            // ATTN: convert const qualifier to non const
            CIMQualifier cimQualifier = cimProperty.getQualifier(i).clone();

            PEGASUS_STD(cout) << "updating qualifier - " << cimQualifier.getName().getString() << PEGASUS_STD(endl);

            newProperty.addQualifier(_resolveQualifier(referenceQualifier, cimQualifier));
        }
    }

    PEGASUS_STD(cout) << newProperty.getName().getString() << " class origin = " << newProperty.getClassOrigin().getString() << PEGASUS_STD(endl);

    return(newProperty);
}

static CIMParameter _resolveParameter(
    const CIMParameter & referenceParameter,
    const CIMParameter & cimParameter,
    const Boolean includeQualifiers)
{
    PEGASUS_STD(cout) << "_resolveParameter(" << referenceParameter.getName().getString() << ")" << PEGASUS_STD(endl);
    PEGASUS_STD(cout) << "flags :";
    PEGASUS_STD(cout) << " includeQualifiers = " << (includeQualifiers == true ? "true" : "false");
    PEGASUS_STD(cout) << PEGASUS_STD(endl);

    CIMParameter newParameter;

    return(newParameter);
}

static CIMMethod _resolveMethod(
    const CIMMethod & referenceMethod,
    const CIMMethod & cimMethod,
    const Boolean includeQualifiers,
    const Boolean includeClassOrigin)
{
    PEGASUS_STD(cout) << "_resolveMethod(" << referenceMethod.getName().getString() << ")" << PEGASUS_STD(endl);
    PEGASUS_STD(cout) << "flags :";
    PEGASUS_STD(cout) << " includeQualifiers = " << (includeQualifiers == true ? "true" : "false");
    PEGASUS_STD(cout) << " includeClassOrigin = " << (includeClassOrigin == true ? "true" : "false");
    PEGASUS_STD(cout) << PEGASUS_STD(endl);

    CIMMethod newMethod;

    return(newMethod);
}

static CIMClass _resolveClass(
    const CIMClass & referenceClass,
    const CIMClass & cimClass,
    const Boolean localOnly,
    const Boolean includeQualifiers,
    const Boolean includeClassOrigin,
    const CIMPropertyList & propertyList)
{
    PEGASUS_STD(cout) << "_resolveClass(" << referenceClass.getClassName().getString() << " : " << referenceClass.getSuperClassName().getString() << ")" << PEGASUS_STD(endl);
    PEGASUS_STD(cout) << "flags :";
    PEGASUS_STD(cout) << " localOnly = " << (localOnly == true ? "true" : "false");
    PEGASUS_STD(cout) << " includeQualifiers = " << (includeQualifiers == true ? "true" : "false");
    PEGASUS_STD(cout) << " includeClassOrigin = " << (includeClassOrigin == true ? "true" : "false");
    PEGASUS_STD(cout) << PEGASUS_STD(endl);

    // get object path elements
    String hostName = referenceClass.getPath().getHost();
    CIMNamespaceName nameSpace = referenceClass.getPath().getNameSpace();
    CIMName className = referenceClass.getPath().getClassName();
    CIMName superClassName = referenceClass.getSuperClassName();

    // create "resolved" class
    CIMClass newClass(className);

    // set object path
    newClass.setPath(CIMObjectPath(hostName, nameSpace, className));

    // set super class name
    newClass.setSuperClassName(referenceClass.getSuperClassName());

    if(includeQualifiers)
    {
        // apply reference class qualifiers
        for(Uint32 i = 0, n = referenceClass.getQualifierCount(); i < n;i++)
        {
            // ATTN: convert const qualifier to non const
            CIMQualifier referenceQualifier = referenceClass.getQualifier(i).clone();

            PEGASUS_STD(cout) << "adding qualifier - " << referenceQualifier.getName().getString() << PEGASUS_STD(endl);

            newClass.addQualifier(referenceQualifier);
        }

        // apply specified class qualifiers
        for(Uint32 i = 0, n = cimClass.getQualifierCount(); i < n; i++)
        {
            Uint32 pos = newClass.findQualifier(cimClass.getQualifier(i).getName());

            if(pos == PEG_NOT_FOUND)
            {
                // ATTN: is it legal to specify qualifiers not in the class definition?
            }

            // get the recently added qualifier from the class
            CIMQualifier referenceQualifier = newClass.getQualifier(pos);

            // ATTN: temporarily remove qualifier until a better way to update is implemented.
            newClass.removeQualifier(pos);

            // ATTN: convert const qualifier to non const
            CIMQualifier cimQualifier = cimClass.getQualifier(i).clone();

            PEGASUS_STD(cout) << "updating qualifier - " << cimQualifier.getName().getString() << PEGASUS_STD(endl);

            newClass.addQualifier(_resolveQualifier(referenceQualifier, cimQualifier));
        }
    }

    // apply reference class properties
    for(Uint32 i = 0, n = referenceClass.getPropertyCount(); i < n; i++)
    {
        // ATTN: convert const property to non const
        CIMProperty referenceProperty = referenceClass.getProperty(i).clone();

        if(localOnly && (!superClassName.isNull()) && (!referenceProperty.getPropagated()))
        {
            PEGASUS_STD(cout) << "adding property - " << referenceProperty.getName().getString() << PEGASUS_STD(endl);

            CIMProperty cimProperty = referenceClass.getProperty(i).clone();

            newClass.addProperty(_resolveProperty(referenceProperty, cimProperty, includeQualifiers, includeClassOrigin));
        }
        else
        {
            PEGASUS_STD(cout) << "ignoring property - " << referenceProperty.getName().getString() << PEGASUS_STD(endl);
        }
    }

    // apply reference class methods
    for(Uint32 i = 0, n = referenceClass.getMethodCount(); i < n; i++)
    {
        // ATTN: convert const method to non const
        CIMMethod referenceMethod = referenceClass.getMethod(i).clone();

        if(localOnly && (!superClassName.isNull()) && (!referenceMethod.getPropagated()))
        {
            PEGASUS_STD(cout) << "adding method - " << referenceMethod.getName().getString() << PEGASUS_STD(endl);

            CIMMethod cimMethod = referenceClass.getMethod(i).clone();

            newClass.addMethod(_resolveMethod(referenceMethod, cimMethod, includeQualifiers, includeClassOrigin));
        }
        else
        {
            PEGASUS_STD(cout) << "ignoring method - " << referenceMethod.getName().getString() << PEGASUS_STD(endl);
        }
    }

    // TODO: check for properties in the specified class that do not exist in the reference class

    /*
    // apply specified class properties
    for(Uint32 i = 0, n = cimClass.getPropertyCount(); i < n; i++)
    {
        if(localOnly && !cimClass.getProperty(i).isPropagated())
        {
            Uint32 pos = cimClass.findProperty(cimClass.getProperty(i).getName());

            if(pos == PEG_NOT_FOUND)
            {
                // throw invalid property
            }

            CIMProperty referenceProperty = newClass.getProperty(pos);

            // ATTN: temporarily remove property until a better way to update is implemented.
            newClass.removeProperty(pos);

            // ATTN: convert const property to non const
            CIMProperty cimProperty = cimClass.getProperty(i).clone();

            PEGASUS_STD(cout) << "updating property - " << cimProperty.getName().getString() << PEGASUS_STD(endl);

            newClass.addProperty(_resolveProperty(referenceProperty, cimProperty, includeQualifiers, includeClassOrigin));
        }
    }

    // apply specified class methods
    for(Uint32 i = 0, n = referenceClass.getMethodCount(); i < n; i++)
    {
        // TODO: needs implementation

        // TODO: do parameters have default values? can they be changed? what else can be overriden/added?
    }
    */

    // ATTN: work around bug in CIMClass (null class origin is automatically updated)
    if(!includeClassOrigin)
    {
        for(Uint32 i = 0, n = newClass.getPropertyCount(); i < n; i++)
        {
            newClass.getProperty(i).setClassOrigin(CIMName());
        }

        // methods seem to work fine
    }

    return(newClass);
}

static CIMInstance _resolveInstance(
    const CIMInstance & referenceInstance,
    const CIMInstance & cimInstance,
    const Boolean localOnly,
    const Boolean includeQualifiers,
    const Boolean includeClassOrigin,
    const CIMPropertyList & propertyList)
{
    PEGASUS_STD(cout) << "_resolveInstance()" << PEGASUS_STD(endl);

    PEGASUS_STD(cout) << "localOnly = " << (localOnly == true ? "true" : "false") << PEGASUS_STD(endl);
    PEGASUS_STD(cout) << "includeQualifiers = " << (includeQualifiers == true ? "true" : "false") << PEGASUS_STD(endl);
    PEGASUS_STD(cout) << "includeClassOrigin = " << (includeClassOrigin == true ? "true" : "false") << PEGASUS_STD(endl);

    // get object path elements
    String hostName = referenceInstance.getPath().getHost();
    CIMNamespaceName nameSpace = referenceInstance.getPath().getNameSpace();
    CIMName className = referenceInstance.getPath().getClassName();

    // create "resolved" instance
    CIMInstance newInstance(className);

    newInstance.setPath(CIMObjectPath(hostName, nameSpace, className));

    if(includeQualifiers)
    {
        // apply reference instance qualifiers
        for(Uint32 i = 0, n = referenceInstance.getQualifierCount(); i < n;i++)
        {
            // ATTN: convert const qualifier to non const
            CIMQualifier referenceQualifier = referenceInstance.getQualifier(i).clone();

            PEGASUS_STD(cout) << "adding qualifier - " << referenceQualifier.getName().getString() << PEGASUS_STD(endl);

            newInstance.addQualifier(referenceQualifier);
        }

        // apply specified class qualifiers
        for(Uint32 i = 0, n = cimInstance.getQualifierCount(); i < n; i++)
        {
            Uint32 pos = newInstance.findQualifier(cimInstance.getQualifier(i).getName());

            if(pos == PEG_NOT_FOUND)
            {
                // ATTN: is it legal to specify qualifiers not in the class definition?
            }

            // get the recently added qualifier from the class
            CIMQualifier referenceQualifier = newInstance.getQualifier(pos);

            // ATTN: temporarily remove qualifier until a better way to update is implemented.
            newInstance.removeProperty(pos);

            // ATTN: convert const qualifier to non const
            CIMQualifier cimQualifier = cimInstance.getQualifier(i).clone();

            PEGASUS_STD(cout) << "updating qualifier - " << cimQualifier.getName().getString() << PEGASUS_STD(endl);

            newInstance.addQualifier(_resolveQualifier(referenceQualifier, cimQualifier));
        }
    }

    // apply reference instance properties
    for(Uint32 i = 0, n = referenceInstance.getPropertyCount(); i < n; i++)
    {
        // ATTN: convert const property to non const
        CIMProperty referenceProperty = referenceInstance.getProperty(i).clone();
        CIMProperty cimProperty = referenceInstance.getProperty(i).clone();

        PEGASUS_STD(cout) << "adding property - " << referenceProperty.getName().getString() << PEGASUS_STD(endl);

        newInstance.addProperty(_resolveProperty(referenceProperty, cimProperty, includeQualifiers, includeClassOrigin));
    }

    // apply specified instance properties
    for(Uint32 i = 0, n = cimInstance.getPropertyCount(); i < n; i++)
    {
        Uint32 pos = cimInstance.findProperty(cimInstance.getProperty(i).getName());

        if(pos == PEG_NOT_FOUND)
        {
            // throw invalid property
        }

        CIMProperty referenceProperty = newInstance.getProperty(pos);

        // ATTN: temporarily remove property until a better way to update is implemented.
        newInstance.removeProperty(pos);

        // ATTN: convert const property to non const
        CIMProperty cimProperty = cimInstance.getProperty(i).clone();

        PEGASUS_STD(cout) << "updating property - " << cimProperty.getName().getString() << PEGASUS_STD(endl);

        newInstance.addProperty(_resolveProperty(referenceProperty, cimProperty, includeQualifiers, includeClassOrigin));
    }

    // update keys
    Array<CIMKeyBinding> keys = referenceInstance.getPath().getKeyBindings();

    for(Uint32 i = 0, n = keys.size(); i < n; i++)
    {
        Uint32 pos = newInstance.findProperty(keys[i].getName());

        if(pos == PEG_NOT_FOUND)
        {
            // throw missing key. it must be present to create a valid object path
        }

        CIMValue value = newInstance.getProperty(pos).getValue();

        // ATTN: check type

        keys[i].setValue(value.toString());
    }

    // udpate object path
    CIMObjectPath path = newInstance.getPath();

    path.setKeyBindings(keys);

    newInstance.setPath(path);

    return(newInstance);
}

static CIMInstance _resolveIndication(
    const CIMIndication & referenceIndication,
    const CIMIndication & cimIndication,
    const Boolean localOnly,
    const Boolean includeQualifiers,
    const Boolean includeClassOrigin,
    const CIMPropertyList & propertyList)
{
    PEGASUS_STD(cout) << "_resolveIndication()" << PEGASUS_STD(endl);

    CIMNamespaceName nameSpace = referenceIndication.getPath().getNameSpace();
    CIMName className = referenceIndication.getPath().getClassName();

    PEGASUS_STD(cout) << "localOnly = " << (localOnly == true ? "true" : "false") << PEGASUS_STD(endl);
    PEGASUS_STD(cout) << "includeQualifiers = " << (includeQualifiers == true ? "true" : "false") << PEGASUS_STD(endl);
    PEGASUS_STD(cout) << "includeClassOrigin = " << (includeClassOrigin == true ? "true" : "false") << PEGASUS_STD(endl);

    CIMIndication newIndication;

    return(newIndication);
}

static CIMMethod _resolveMethod(
    const CIMMethod & referenceMethod,
    const CIMMethod & cimMethod,
    const Uint32 flags)
{
    PEGASUS_STD(cout) << "_resolveMethod()" << PEGASUS_STD(endl);

    CIMMethod newMethod;

    return(newMethod);
}

static CIMParameter _resolveParameter(
    const CIMParameter & referenceParameter,
    const CIMParameter & cimParameter,
    const Uint32 flags)
{
    PEGASUS_STD(cout) << "_resolveParameter()" << PEGASUS_STD(endl);

    CIMParameter newParameter;

    return(newParameter);
}

ObjectNormalizer::ObjectNormalizer(CIMRepository & repository) : _repository(repository)
{
}

CIMClass ObjectNormalizer::normalizeClass(
    const CIMClass & cimClass,
    const Boolean localOnly,
    const Boolean includeQualifiers,
    const Boolean includeClassOrigin,
    const CIMPropertyList & propertyList)
{
    PEGASUS_STD(cout) << "ObjectNormalizer::resolveClass()" << PEGASUS_STD(endl);

    CIMNamespaceName nameSpace = cimClass.getPath().getNameSpace();
    CIMName className = cimClass.getPath().getClassName();

    CIMClass referenceClass =
        _repository.getClass(
            nameSpace,
            className,
            false,
            true,
            true,
            propertyList);

    // propagate namespace in object
    referenceClass.setPath(CIMObjectPath("", nameSpace, className));

    return(_resolveClass(referenceClass, cimClass, localOnly, includeQualifiers, includeClassOrigin, propertyList));
}

CIMInstance ObjectNormalizer::normalizeInstance(
    const CIMInstance & cimInstance,
    const Boolean localOnly,
    const Boolean includeQualifiers,
    const Boolean includeClassOrigin,
    const CIMPropertyList & propertyList)
{
    Array<CIMInstance> cimInstances;

    cimInstances.append(cimInstance);

    Array<CIMInstance> resolvedInstances =
        normalizeInstances(
            cimInstances,
            localOnly,
            includeQualifiers,
            includeClassOrigin,
            propertyList);

    if(resolvedInstances.size() != 1)
    {
        throw CIMException(CIM_ERR_FAILED);
    }

    return(resolvedInstances[0]);
}

Array<CIMInstance> ObjectNormalizer::normalizeInstances(
    const Array<CIMInstance> & cimInstances,
    const Boolean localOnly,
    const Boolean includeQualifiers,
    const Boolean includeClassOrigin,
    const CIMPropertyList & propertyList)
{
    PEGASUS_STD(cout) << "ObjectNormalizer::resolveInstances()" << PEGASUS_STD(endl);

    // TODO: ensure array is not empty
    // TODO: ensure objects in the array are initialized
    // TODO: ensure all class names are the same

    CIMNamespaceName nameSpace = cimInstances[0].getPath().getNameSpace();
    CIMName className = cimInstances[0].getPath().getClassName();

    // ATTN: get the complete instance and use this resolver to remove extraneous information.
    CIMClass referenceClass =
        _repository.getClass(
            nameSpace,
            className,
            false,
            true,
            true,
            CIMPropertyList());

    // make the reference class a reference instance
    CIMInstance referenceInstance(className);

    // propagate namespace in object
    referenceInstance.setPath(CIMObjectPath("", nameSpace, className));

    // copy qualifiers (if includeQualfiers == false, the class should have none
    // the following code will do nothing)
    for(Uint32 i = 0, n = referenceClass.getQualifierCount(); i < n; i++)
    {
        CIMQualifier cimQualifier = referenceClass.getQualifier(i).clone();

        if(cimQualifier.getFlavor().hasFlavor(CIMFlavor::TOINSTANCE))
        {
            referenceInstance.addQualifier(cimQualifier);
        }
    }

    // copy properties (if localOnly == true, the class should only have
    // local properties and the following code will operate correctly)
    for(Uint32 i = 0, n = referenceClass.getPropertyCount(); i < n; i++)
    {
        CIMProperty cimProperty = referenceClass.getProperty(i).clone();

        referenceInstance.addProperty(cimProperty);
    }

    // TODO: copy methods ???

    Array<CIMInstance> resolvedInstances;

    for(Uint32 i = 0, n = cimInstances.size(); i < n; i++)
    {
        CIMInstance cimInstance =
            _resolveInstance(
                referenceInstance,
                cimInstance,
                localOnly,
                includeQualifiers,
                includeClassOrigin,
                propertyList);

        resolvedInstances.append(cimInstance);
    }

    return(resolvedInstances);
}

CIMIndication ObjectNormalizer::normalizeIndication(
    const CIMIndication & cimIndication,
    const Boolean localOnly,
    const Boolean includeQualifiers,
    const Boolean includeClassOrigin,
    const CIMPropertyList & propertyList)
{
    CIMNamespaceName nameSpace = cimIndication.getPath().getNameSpace();
    CIMName className = cimIndication.getPath().getClassName();

    CIMClass referenceClass =
        _repository.getClass(
            nameSpace,
            className,
            false,
            true,
            true,
            CIMPropertyList());

    CIMIndication referenceIndication(className);

    // propagate namespace in object
    referenceIndication.setPath(CIMObjectPath("", nameSpace, className));

    return(_resolveIndication(referenceIndication, cimIndication, localOnly, includeQualifiers, includeClassOrigin, propertyList));
}

PEGASUS_NAMESPACE_END