blob: b1931c05ddefb4783e4287abc374b4847a1a1517 [file] [log] [blame]
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Mozilla/4.5 [en] (WinNT; U) [Netscape]">
<title>Workbench Extension Points</title>
</head>
<body link="#0000FF" vlink="#800080">
<center>
<h1>
URL Stream Handlers</h1></center>
<b><i>Identifier: </i></b>org.eclipse.core.runtime.urlHandlers
<p><b><i>Description:
</i></b>This extension point is used to register
additional URL handlers to the platform search path. Note, that because
of the platform class loader structure, URL handlers registered by a plug-in
using the standard Java mechanisms will not be found.
<p><b><i>Configuration Markup:</i></b>
<p><tt>&nbsp;&nbsp; &lt;!ELEMENT handler EMPTY></tt>
<p><tt>&nbsp;&nbsp; &lt;!ATTLIST handler</tt>
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; protocol&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
CDATA #REQUIRED</tt>
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; class&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
CDATA #REQUIRED</tt>
<br><tt>&nbsp;&nbsp; ></tt>
<ul>
<li>
<b>protocol -</b> URL protocol</li>
<li>
<b>class</b> - URL stream handler contributed by plug-in</li>
</ul>
<b><i>Examples:</i></b>
<p>Following is an example of a handler configuration:
<p><tt>&nbsp;&nbsp; &lt;extension point="org.eclipse.core.runtime.urlHandlers"></tt>
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;handler protocol="foo" class="org.eclipse.handlers.FooHandler"/></tt>
<br><tt>&nbsp;&nbsp; &lt;/extension></tt>
<p><b><i>API Information</i>: </b>The value of the <tt>class</tt> attribute
must represent an implementor of implementation of <tt>java.net.URLStreamHandler</tt>
<p><b><i>Supplied Implementation:</i></b> The platform itself does not
supply any URL handlers registered through this extension point..
<p><a href="hglegal.htm"><img SRC="ngibmcpy.gif" ALT="Copyright IBM Corp. 2000, 2001. All Rights Reserved." BORDER=0 height=12 width=195></a>
</body>
</html>