<h1>xercesc::URLInputSource Class Reference</h1><!-- doxytag: class="xercesc::URLInputSource" --><!-- doxytag: inherits="xercesc::InputSource" -->This class is a derivative of the standard <aclass="el"href="classxercesc_1_1InputSource.html">InputSource</a> class.
Inheritance diagram for xercesc::URLInputSource:<p><center><imgsrc="classxercesc_1_1URLInputSource__inherit__graph.png"border="0"usemap="#xercesc_1_1URLInputSource__inherit__map"alt="Inheritance graph"></center>
<center><fontsize="2">[<ahref="graph_legend.html">legend</a>]</font></center><ahref="classxercesc_1_1URLInputSource-members.html">List of all members.</a><tableborder="0"cellpadding="0"cellspacing="0">
<tr><td></td></tr>
<tr><tdcolspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><tdclass="mdescLeft"> </td><tdclass="mdescRight">This method will return a binary input stream derivative that will parse from the source refered to by the URL system id. <ahref="#3ad592d7ac5a359a59f9b2c6139bad49"></a><br></td></tr>
<tr><tdclass="mdescLeft"> </td><tdclass="mdescRight">This method will return a const reference to the URL member which contains the system id in pre-parsed URL form. <ahref="#e91b1d6f5d8f6c55bff0d02d764bd1d7"></a><br></td></tr>
This class is a derivative of the standard <aclass="el"href="classxercesc_1_1InputSource.html">InputSource</a> class.
<p>
It provides for the parser access to data which is referenced via a URL, as apposed to a local file name. The URL can be provided via an XMLURL class, as a fully qualified system id, or a base system id and a system id which may be fully qualified or may be relative to the base.<p>
As with all <aclass="el"href="classxercesc_1_1InputSource.html">InputSource</a> derivatives. The primary objective of an input source is to create an input stream via which the parser can spool in data from the referenced source.<p>
Note that the parse system does not necessarily support URL based XML entities out of the box. Support for socket based access is optional and controlled by the per-platform support.
<p>
<hr><h2>Constructor & Destructor Documentation</h2>
It is assumed that it is correct and it will be used as is. In this case, no public id accepted, but it can still be set via the parent class' <aclass="el"href="classxercesc_1_1InputSource.html#d88b92735d82dcadf39496ca83357aec">setPublicId()</a> method.<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>urlId</em> </td><td>The URL which holds the system id of the entity to parse. </td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects. </td></tr>
This constructor takes a base system id URL and a possibly relative system id.
<p>
The relative part is parsed and, if it is indeed relative, it will be made relative to the passed base id. Otherwise, it will be taken as is.<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>baseId</em> </td><td>The base system id URL which provides the base for any relative id part.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>systemId</em> </td><td>The possibly relative system id URL. If its relative its based on baseId, else its taken as is. </td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects. </td></tr>
This constructor is indentical to the previous one, except that it also allows you to set a public id if you want to.
<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>baseId</em> </td><td>The base system id URL which provides the base for any relative id part.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>systemId</em> </td><td>The possibly relative system id URL. If its relative its based on baseId, else its taken as is.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>publicId</em> </td><td>The optional public id to set. This is just passed on to the parent class for storage.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects. </td></tr>
This constructor is identical to the second constructor above, except that it accepts the relative system id part as a local code page string and just transcodes it internally, as a convenience.
<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>baseId</em> </td><td>The base system id URL which provides the base for any relative id part.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>systemId</em> </td><td>The possibly relative system id URL. If its relative its based on baseId, else its taken as is.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects. </td></tr>
This constructor is identical to the third constructor above, except that it accepts the relative and public ids as local code page strings and just transcodes them internally, as a convenience.
<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>baseId</em> </td><td>The base system id URL which provides the base for any relative id part.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>systemId</em> </td><td>The possibly relative system id URL. If its relative its based on baseId, else its taken as is.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>publicId</em> </td><td>The optional public id to set. This is just passed on to the parent class for storage. on to the parent class for storage.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects. </td></tr>
It is assumed that it is correct and it will be used as is. In this case, no public id accepted, but it can still be set via the parent class' <aclass="el"href="classxercesc_1_1InputSource.html#d88b92735d82dcadf39496ca83357aec">setPublicId()</a> method.<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>urlId</em> </td><td>The URL which holds the system id of the entity to parse. </td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects. </td></tr>
This constructor takes a base system id URL and a possibly relative system id.
<p>
The relative part is parsed and, if it is indeed relative, it will be made relative to the passed base id. Otherwise, it will be taken as is.<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>baseId</em> </td><td>The base system id URL which provides the base for any relative id part.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>systemId</em> </td><td>The possibly relative system id URL. If its relative its based on baseId, else its taken as is. </td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects. </td></tr>
This constructor is indentical to the previous one, except that it also allows you to set a public id if you want to.
<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>baseId</em> </td><td>The base system id URL which provides the base for any relative id part.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>systemId</em> </td><td>The possibly relative system id URL. If its relative its based on baseId, else its taken as is.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>publicId</em> </td><td>The optional public id to set. This is just passed on to the parent class for storage.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects. </td></tr>
This constructor is identical to the second constructor above, except that it accepts the relative system id part as a local code page string and just transcodes it internally, as a convenience.
<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>baseId</em> </td><td>The base system id URL which provides the base for any relative id part.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>systemId</em> </td><td>The possibly relative system id URL. If its relative its based on baseId, else its taken as is.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects. </td></tr>
This constructor is identical to the third constructor above, except that it accepts the relative and public ids as local code page strings and just transcodes them internally, as a convenience.
<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>baseId</em> </td><td>The base system id URL which provides the base for any relative id part.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>systemId</em> </td><td>The possibly relative system id URL. If its relative its based on baseId, else its taken as is.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>publicId</em> </td><td>The optional public id to set. This is just passed on to the parent class for storage. on to the parent class for storage.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects. </td></tr>
If you just want the string format, call <aclass="el"href="classxercesc_1_1InputSource.html#a3a868b2a61ab8cf886c586d18a6bf3c">getSystemId()</a> on the parent class.<p>
<dlclass="return"compact><dt><b>Returns:</b></dt><dd>A const reference to a URL object that contains the current system id set for this input source. </dd></dl>