//Utility Management System Data Access Facility - OMG IDL Summary File
//Object Management Group, Inc.
//
//Copyright 2002, Alstom ESCA
//Copyright 2002, Langdale Consultants
//
//The companies listed above have granted to the Object Management Group, Inc. 
//(OMG) a nonexclusive, royalty-free, paid up, worldwide license to copy and 
//distribute this document and to modify this document and distribute copies of 
//the modified version. Each of the copyright holders listed above has agreed 
//that no person shall be deemed to have infringed the copyright in the included 
//material of any such copyright holder by reason of having used the 
//specification set forth herein or having conformed any computer software to 
//the specification. 
//
//This file contains OMG IDL from the Python Language, v1.0 specification.
//OMG regularly publishes a summary file that contains all the "code" parts of 
//an OMG formal document. Every formal document line that is IDL, PIDL, or 
//language code is included in the summary file. The reason for such a listing 
//is to give readers an electronic version of the "code" so that they can 
//extract pieces of it. Readers might want to test an example, include it in 
//their own code, or use it for documentation purposes. Having the code lines 
//available electronically means there is less likelihood of a transcription 
//error. 
//

//File: DAFIdentifiers.idl
#ifndef _DAF_IDENTIFIERS_IDL_
#define _DAF_IDENTIFIERS_IDL_
#pragma prefix "omg.org"
module DAFIdentifiers
{
	// the uniform resource identifier from IETF RFC 2396
	typedef string URI;
	typedef sequence< URI > URISequence;

	// the resource identifier
	struct ResourceID
	{
		unsigned long long container;
		unsigned long long fragment;
	};
	typedef sequence < ResourceID > ResourceIDSequence;

	// service for translating and managing resource identifiers
	exception LookupError { string reason; };
	interface ResourceIDService
	{
		ResourceIDSequence get_resource_ids(
		in URISequence uris )
		raises( LookupError );

		URISequence get_uris(
		in ResourceIDSequence ids )
		raises( LookupError );
	};
};
#endif // _DAF_IDENTIFIERS_IDL_


//File: DAFDescriptions.idl
// Change history
// DAIS RTF	1.0 7084 2004-09-09	Unspecified data type added
#ifndef _DAF_DESCRIPTIONS_IDL_
#define _DAF_DESCRIPTIONS_IDL_
#include <DAFIdentifiers.idl>
#include <TimeBase.idl>
#pragma prefix "omg.org"
module DAFDescriptions
{
	//++
	// Simple Types used as property values.
	//--
	// imported from identifiers module.
	typedef DAFIdentifiers::ResourceID ResourceID;
	typedef DAFIdentifiers::URI URI;

	// absolute time stamps in 100 nanosecond units
	// base time is 15 October 1582 00:00 UTC
	// as per Time Service specification
	typedef TimeBase::TimeT DateTime;

	// a complex number
	struct Complex
	{
		double real;
		double imaginary;
	};

	// a blob
	typedef string						FileExtension;

	struct Blob
	{
		any								blob_data;
		FileExtension					blob_data_type;
	}; 

	//++
	// Resource Descriptions
	//--
	// properties are represented by their resource identifiers
	typedef ResourceID PropertyID;

	// SimpleValue's can take on the following types.
	typedef short SimpleValueType;
	const SimpleValueType UNSPECIFIED_TYPE = 0; //7084
	const SimpleValueType RESOURCE_TYPE = 1;
	const SimpleValueType URI_TYPE = 2;
	const SimpleValueType STRING_TYPE = 3;
	const SimpleValueType BOOLEAN_TYPE = 4;
	const SimpleValueType INT_TYPE = 5;
	const SimpleValueType UNSIGNED_TYPE = 6;
	const SimpleValueType DOUBLE_TYPE = 7;
	const SimpleValueType COMPLEX_TYPE = 8;
	const SimpleValueType DATE_TIME_TYPE = 9;
	const SimpleValueType ULONG_LONG_TYPE = 10;
	const SimpleValueType BLOB_TYPE = 11;
	const SimpleValueType PROPERTYID_TYPE = 12;
	const SimpleValueType RESOURCES_TYPE = 101;
	const SimpleValueType URIS_TYPE = 102;
	const SimpleValueType STRINGS_TYPE = 103;	
	const SimpleValueType BOOLEANS_TYPE = 104;
	const SimpleValueType INTS_TYPE = 105;
	const SimpleValueType UNSIGNEDS_TYPE = 106;
	const SimpleValueType DOUBLES_TYPE = 107;	
	const SimpleValueType COMPLEXES_TYPE = 108;
	const SimpleValueType DATE_TIMES_TYPE = 109;
	const SimpleValueType ULONG_LONGS_TYPE = 110;	
	const SimpleValueType BLOBS_TYPE = 111;
	const SimpleValueType PROPERTYIDS_TYPE = 112;

	// a SimpleValue is the object of a resource description.
	union SimpleValue switch( SimpleValueType )
	{
		case RESOURCE_TYPE	: ResourceID resource_value;
		case URI_TYPE		: URI uri_value;
		case STRING_TYPE	: string string_value;
		case BOOLEAN_TYPE	: boolean boolean_value;
		case INT_TYPE		: long int_value;
		case UNSIGNED_TYPE	: unsigned long unsigned_value;
		case DOUBLE_TYPE	: double double_value;
		case COMPLEX_TYPE	: Complex complex_value;
		case DATE_TIME_TYPE : DateTime date_time_value;
		case ULONG_LONG_TYPE : unsigned long long ulong_long_value;
		case BLOB_TYPE		: Blob blob_value;
		case PROPERTYID_TYPE : PropertyID propertyid_value;
		case RESOURCES_TYPE : sequence<ResourceID> resource_values;
		case URIS_TYPE      : sequence<URI> uri_values;
		case STRINGS_TYPE   : sequence<string> string_values;
		case BOOLEANS_TYPE  : sequence<boolean> boolean_values;
		case INTS_TYPE      : sequence<long> int_values;
		case UNSIGNEDS_TYPE : sequence<unsigned long> unsigned_values;
		case DOUBLES_TYPE   : sequence<double> double_values;
		case COMPLEXES_TYPE : sequence<Complex> complex_values;
		case DATE_TIMES_TYPE: sequence<DateTime> date_time_values;
		case ULONG_LONGS_TYPE : sequence<unsigned long long> ulong_long_values;
		case PROPERTYIDS_TYPE : sequence<PropertyID> propertyid_values;
	};

	// predicate and object for a resource description
	struct PropertyValue
	{
		PropertyID property;
		SimpleValue value;
	};
	typedef sequence<PropertyValue> PropertyValueSequence;

	// resource description with one subject, multiple predicates
	struct ResourceDescription
	{
		ResourceID id;
		PropertyValueSequence values;
	};
	typedef sequence<ResourceDescription> ResourceDescriptionSequence;

	// iterator for handling large numbers of resource descriptions
	interface ResourceDescriptionIterator
	{
		unsigned long max_left();
		boolean next_n(
		in unsigned long n,
		out ResourceDescriptionSequence descriptions );
		void destroy();
	};
};
#endif // _DAF_DESCRIPTIONS_IDL_


//File: DAFQuery.idl
#ifndef _DAF_QUERY_IDL_
#define _DAF_QUERY_IDL_

#include <DAFDescriptions.idl>

#pragma prefix "omg.org"
module DAFQuery
{
	// properties and classes are represented by resource identifiers
	// imported from the identifiers module.
	typedef DAFIdentifiers::ResourceID ResourceID;
	typedef DAFIdentifiers::ResourceID ClassID;
	typedef DAFIdentifiers::ResourceID PropertyID;
	typedef DAFIdentifiers::ResourceIDSequence PropertySequence;

	// results are resource descriptions from the descriptions module
	typedef DAFDescriptions::ResourceDescription ResourceDescription;																			
	typedef DAFDescriptions::ResourceDescriptionIterator
			ResourceDescriptionIterator;									

	// queries that perform navigation use the association concept
	struct Association
	{
		PropertyID			property;
		ClassID			type;
		boolean			inverse; };
	typedef sequence<Association> AssociationSequence;

	// exceptions generated by queries
	exception UnknownAssociation { string reason; };
	exception UnknownResource { string reason; };
	exception QueryError { string reason; };

	// the query service
	interface ResourceQueryService 
	{
		ResourceDescription get_values( 
			in ResourceID resource, 
			in PropertySequence properties) 
			raises( UnknownResource, QueryError );

		ResourceDescriptionIterator get_extent_values(
			in PropertySequence properties, 
			in ClassID class_id )
			raises (UnknownResource, QueryError);

		ResourceDescriptionIterator get_related_values(
			in PropertySequence properties, 
			in Association association, 
			in ResourceID source )
			raises ( UnknownResource, UnknownAssociation, QueryError );

		ResourceDescriptionIterator get_descendent_values(
			in PropertySequence properties, 
			in AssociationSequence path, 
			in ResourceIDSequence sources,
			out AssociationSequence tail )
			raises ( UnknownResource, QueryError );
	};
};
#endif // _DAF_QUERY_IDL_

//File: DAFEvents.idl
#ifndef _DAF_EVENTS_IDL_
#define _DAF_EVENTS_IDL_

#include <DAFIdentifiers.idl>
#include <CosEventChannelAdmin.idl>

#pragma prefix "omg.org"
module DAFEvents
{
	// event emitted by data provider after data changes
	struct ResourceChangeEvent
	{
		DAFIdentifiers::ResourceIDSequence affected;
	};

	// interface for connection an event push consumer
	interface ResourceEventSource
	{
							CosEventChannelAdmin::ProxyPushSupplier obtain_push_supplier();
		unsigned long long current_version();
	};
};
#endif // _DAF_EVENTS_IDL_