FileDocCategorySizeDatePackage
ReservationDescriptorFactory.javaAPI DocphoneME MR2 API (J2ME)2691Wed May 02 18:00:00 BST 2007com.sun.midp.push.gcf

ReservationDescriptorFactory

public interface ReservationDescriptorFactory
Factory class to produce ReservationDescriptors.

Fields Summary
Constructors Summary
Methods Summary
public ReservationDescriptorgetDescriptor(java.lang.String connectionName, java.lang.String filter, PermissionCallback permissionCallback)
Returns push reservation descriptor.

Validates parameters passed, checks connection permissions and if everything's fine, creates an instance of {@link ReservationDescriptor} which would allow to reserve the connection.

param
connectionName same as connection parameter passed into {@link javax.microedition.io.PushRegistry#registerConnection} (cannot be null)
param
filter filter as passed into {@link javax.microedition.io.PushRegistry#registerConnection} (cannot be null)
param
permissionCallback callback to check permissions (cannot be null, use dummy implementation if there is need to bypass security checks)
return
connection descriptor (always not null)
throws
IllegalArgumentException if the connection string is not valid, or if the filter string is not valid
throws
ConnectionNotFoundException if the runtime system does not support push delivery for the requested connection protocol