Package org.somda.sdc.dpws.device

Interface HostingServiceAccess

All Known Implementing Classes:

DeviceImpl

public interface HostingServiceAccess

Interface to access the hosting service provided by a Device.

Important note: there is no support to remove or alter hosted services that have been added before.

Method Summary

Modifier and Type	Method	Description
void	addHostedService(HostedService hostedService)	Adds a hosted service definition.
void	setThisDevice(org.somda.sdc.dpws.model.ThisDeviceType thisDevice)	Adds the ThisModel definition.
void	setThisModel(org.somda.sdc.dpws.model.ThisModelType thisModel)	Updates the ThisModel definition.

Method Details

setThisDevice

void setThisDevice(org.somda.sdc.dpws.model.ThisDeviceType thisDevice)

Adds the ThisModel definition.

According to the DPWS specification, certain information is limited in the number of characters:

• ThisDeviceType.getFriendlyName() shall have fewer than DpwsConstants.MAX_FIELD_SIZE octets
• ThisDeviceType.getFirmwareVersion() shall have fewer than DpwsConstants.MAX_FIELD_SIZE octets
• ThisDeviceType.getSerialNumber() ()} shall have fewer than DpwsConstants.MAX_FIELD_SIZE octets

Attention: If those limits are exceeded, the underlying implementation may cut off overflowing characters.

Parameters:

thisDevice - the ThisModel information to set.

See Also:

• 4.1 Characteristics

setThisModel

void setThisModel(org.somda.sdc.dpws.model.ThisModelType thisModel)

Updates the ThisModel definition.

According to the DPWS specification, certain information is limited in the number of characters:

• ThisModelType.getManufacturer() ()} shall have fewer than DpwsConstants.MAX_FIELD_SIZE octets
• ThisModelType.getModelName() ()} shall have fewer than DpwsConstants.MAX_FIELD_SIZE octets
• ThisModelType.getModelNumber() ()} ()} shall have fewer than DpwsConstants.MAX_FIELD_SIZE octets
• ThisModelType.getManufacturerUrl() shall have fewer than DpwsConstants.MAX_URI_SIZE octets
• ThisModelType.getModelUrl() ()} shall have fewer than DpwsConstants.MAX_URI_SIZE octets

Attention: If those limits are exceeded, the underlying implementation may cut off overflowing characters.

Parameters:

thisModel - the ThisModel information to set.

See Also:

• 4.1 Characteristics

addHostedService

void addHostedService(HostedService hostedService)

Adds a hosted service definition.

Attention: there is currently no mechanism that verifies if the hosted service was added before!

Parameters:

hostedService - the hosted service definition to add.