|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface InteractionChannelTransportProvider
This interface will be implemented by system providers of resource transport via the interaction channel. It will be used by the GEM implementation when accessing resources identified by references (URIs) encountered within the interaction channel protocol descriptor. In addition, this provider may be accessed indirectly from DVB-J applications via the java.io.File and org.dvb.dsmcc.DSMCCObject classes.
Method Summary | |
---|---|
ResourceTransportObject |
createResourceTransportObject(java.lang.String uri)
Create new resource access object in preparation for downloading and using the contents of a network resource via the interaction channel. |
boolean |
exists(java.lang.String uri)
Return a flag indicating whether the specified resource exists. |
boolean |
existsSupported()
Return a flag indicating whether this provider supports existence checks using the exists() method on the provider implementation. |
java.lang.String[] |
getSupportedURISchemes()
Return the list of URI schemes supported by this provider. |
void |
prefetch(java.lang.String uri,
int priority)
Provides a hint to the provider that the resource identified by the specified URI will probably be accessed in the near future, so that if available resources permit and the provider supports prefetching it can take whatever steps are appropriate to speed up the time required to load the file when the subsequent request to load the file is made via the normal call to ResourceTransportObject.synchronousLoad() or
ResourceTransportObject.asynchronousLoad() . |
boolean |
prefetchSupported()
Return a flag indicating whether this provider supports prefetch. |
Methods inherited from interface org.dvb.spi.Provider |
---|
getName, getServiceProviderInterfaces, getVersion, providerRegistered, providerUnregistered |
Method Detail |
---|
java.lang.String[] getSupportedURISchemes()
Note that if http or https are contained in the returned list they will be ignored. In other words, the service provider cannot override the GEM implementation's internal implementation of the HTTP and HTTPS protocols.
ResourceTransportObject createResourceTransportObject(java.lang.String uri)
uri
- URI identifying the resource to be accessed, the
URI scheme of which is guaranteed to be one of
those returned from getSupportedURISchemes
boolean prefetchSupported()
true
does
not guarantee that a call to prefetch()
for a
particular resource will have any effect. It is merely an
indication of whether the provider supports prefetch hints in
general.
prefetch()
methodvoid prefetch(java.lang.String uri, int priority)
ResourceTransportObject.synchronousLoad()
or
ResourceTransportObject.asynchronousLoad()
.
This could include anything from retrieving directory
information to actually downloading the file to memory or
local physical file system, if space is available.
uri
- URI identifying the resource to be accessed, the
URI scheme of which is guaranteed to be one of
those returned from getSupportedURISchemespriority
- hint to the provider about the relative
priority of this resources with respect to
other resources prefetch hints for this
provider (higher = more important).
java.lang.UnsupportedOperationException
- if this provider does
not support prefetching
(i.e. if
prefetchSupported()
returns
false
)boolean existsSupported()
exists()
methodboolean exists(java.lang.String uri)
uri
- URI identifying the resource whose existence to
check, the URI scheme of which is guaranteed to be
one of those returned from
getSupportedURISchemes()
java.lang.UnsupportedOperationException
- if this provider does
not support optimized
existence checks (i.e.
if
existsSupported()
returns
false
)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |