@Retention(SOURCE) @Target(TYPE) public @interface URLStreamHandlerRegistration
URLStreamHandlerFactory
within the NetBeans platform.
(The JVM only permits one global factory to be set at a time,
whereas various independent modules may wish to register handlers.)
May be placed on a URLStreamHandler
implementation to register it.
Your handler will be loaded and used if and when a URL of a matching protocol is created.
A URLStreamHandlerFactory
which uses these registrations may be found in Lookup.getDefault()
.
This factory is active whenever the module system is loaded.
You may also wish to call URL.setURLStreamHandlerFactory(java.net.URLStreamHandlerFactory)
from a unit test or otherwise without the module system active.
Modifier and Type | Required Element | Description |
---|---|---|
String[] |
protocol |
URL protocol(s) which are handled.
|
Modifier and Type | Optional Element | Description |
---|---|---|
int |
position |
An optional position in which to register this handler relative to others.
|
String[] protocol
URLStreamHandler.openConnection(java.net.URL)
will be called with a matching URL.getProtocol()
.Built on April 24 2018. | Portions Copyright 1997-2018 Oracle. All rights reserved.