OSB_LIB::ServiceItem Class Reference

Inheritance diagram for OSB_LIB::ServiceItem:

[legend]Collaboration diagram for OSB_LIB::ServiceItem:

[legend]List of all members.

Detailed Description

Service item keeps the available services (service tuple) to a product.

Each ServiceItem has a service tuple that represents an available service to a product.

Definition at line 144 of file serviceitem.h.

Public Types

typedef std::auto_ptr< ServiceItem > AutoPtr
Short-cut for an auto pointer.

Public Member Functions

ServiceItem (const Oid &oid)
Constructor with only object id provided.
ServiceItem (const Oid &oid, const std::string &name, const std::string &des, const ServiceTuple &st)
Constructor of the service item class.
Type type () const
The type of the product item.
AutoPtr clone () const
Virtual copy construction.
virtual ProductItem::CfgType canConfigure () const
The configuration type of service item (Mandatory).
virtual ProductItem::DefPersType canDefPers () const
The default personalization type of service item (None).
CfgPersType canPersonalize () const
The personalization type of service item.
const PersProductItem * defPersItem () const
Pointer to the default personalize product item.
std::auto_ptr< PersProductItem > crePersProductItem () const
Create an auto pointer of PersService.

Read access to data member:

const ServiceTuple & serviceTuple () const
Retrieve the service tuple represented by this service item.

Modify data members:

void setServiceTuple (const ServiceTuple &service)
Set the service represented by this service item.

Static Public Attributes

static const Type type_
The product item type id: PiType::piService.

Private Member Functions

virtual ProductItem * clone_ () const
Virtual copy construction.

Database operation:

virtual bool readSpecific (const OSB_DB::Session &session)
Read a service item from database.
virtual bool insSpecific (const OSB_DB::Session &session)
Insert a service item into database.
virtual bool updSpecific (const OSB_DB::Session &session)
Updata a service item in the database.
virtual bool delSpecific (const OSB_DB::Session &session)
Delete a service item from the database.

Private Attributes

ServiceTuple serviceTuple_
ServiceTuple contained in this ServiceItem.
PersService defPersService_
Default personalize service item.

Friends

struct OSB_DB::ServiceItemGw
The database gateway needs to populate data members after construction.

Member Typedef Documentation

typedef std::auto_ptr<ServiceItem> OSB_LIB::ServiceItem::AutoPtr

Short-cut for an auto pointer.

For details see quality manual, implementation patterns: Virtual copy construction.

Reimplemented from OSB_LIB::ProductItem.

Definition at line 155 of file serviceitem.h.

Constructor & Destructor Documentation

OSB_LIB::ServiceItem::ServiceItem ( const Oid & oid )

Constructor with only object id provided.

OSB_LIB::ServiceItem::ServiceItem	(	const Oid &	oid,
		const std::string &	name,
		const std::string &	des,
		const ServiceTuple &	st
	)

Constructor of the service item class.

This constructor will take in a service tuple and create an instance of service item that contains the said service tuple. Besides that, it also accept a parameter which indicates the type of personalization applied to this instance.

Parameters:

	oid	Database link of this object.
	name	Name of this service item.
	des	Description of this service Item.
	st	ServiceTuple that is to be represented.

Member Function Documentation

virtual ProductItem::CfgType OSB_LIB::ServiceItem::canConfigure ( ) const [inline, virtual]

The configuration type of service item (Mandatory).

Implements OSB_LIB::ProductItem.

Definition at line 206 of file serviceitem.h.

References OSB_LIB::ProductItem::cfgMandatory.

virtual ProductItem::DefPersType OSB_LIB::ServiceItem::canDefPers ( ) const [inline, virtual]

The default personalization type of service item (None).

Implements OSB_LIB::ProductItem.

Definition at line 212 of file serviceitem.h.

References OSB_LIB::ProductItem::defPersNone.

CfgPersType OSB_LIB::ServiceItem::canPersonalize ( ) const [virtual]

The personalization type of service item.

Implements OSB_LIB::ProductItem.

AutoPtr OSB_LIB::ServiceItem::clone ( ) const

Virtual copy construction.

For details see quality manual, implementation patterns.

Reimplemented from OSB_LIB::ProductItem.

virtual ProductItem* OSB_LIB::ServiceItem::clone_ ( ) const [private, virtual]

Virtual copy construction.

For details see quality manual, implementation patterns.

Implements OSB_LIB::ProductItem.

std::auto_ptr<PersProductItem> OSB_LIB::ServiceItem::crePersProductItem ( ) const [virtual]

Create an auto pointer of PersService.

This function will create an auto_ptr of PersService and initialize it with default personalization.

Returns:: An auto pointer to a PersService.

Implements OSB_LIB::ProductItem.

const PersProductItem* OSB_LIB::ServiceItem::defPersItem ( ) const [virtual]

Pointer to the default personalize product item.

Implements OSB_LIB::ProductItem.

virtual bool OSB_LIB::ServiceItem::delSpecific ( const OSB_DB::Session & session ) [private, virtual]

Delete a service item from the database.

Implements OSB_LIB::ProductItem.

virtual bool OSB_LIB::ServiceItem::insSpecific ( const OSB_DB::Session & session ) [private, virtual]

Insert a service item into database.

Implements OSB_LIB::ProductItem.

virtual bool OSB_LIB::ServiceItem::readSpecific ( const OSB_DB::Session & session ) [private, virtual]

Read a service item from database.

Implements OSB_LIB::ProductItem.

const ServiceTuple& OSB_LIB::ServiceItem::serviceTuple ( ) const

Retrieve the service tuple represented by this service item.

void OSB_LIB::ServiceItem::setServiceTuple ( const ServiceTuple & service )

Set the service represented by this service item.

Parameters:

service

Service to be represented by this service item.

Type OSB_LIB::ServiceItem::type ( ) const [inline, virtual]

The type of the product item.

The function returns the type of the product item. It is needed for only one reason: Corba clients must provide a configuration window that depends on the actual type.

No appropriate design can be provided: Unless on-line clients use the real product item type through-out the whole live cycle of an object, there must be a way to determine the actual type of a product item. No matter how clever we make our design, for on-line clients there will always be one step where they need to determine a product item's type in a switch-like statement. For this step I personally perfer to work with an enumeration type (and compiler warnings) rather than relying on dynamic casts (where errors can be detected only during run-time).