Difference between revisions of "The MIRC RadLex Servlet"

From MircWiki
Jump to navigation Jump to search
Line 7: Line 7:
 
where <b>string</b> is a set of URL-encoded characters. The <b>string</b> parameter is used as an index into the RadLex term index. All terms whose first word starts with the <b>string</b> parameter are returned in an XML structure. The Content-Type of the response is <b>text/xml</b>, and the encoding is <b>UTF-8</b>.
 
where <b>string</b> is a set of URL-encoded characters. The <b>string</b> parameter is used as an index into the RadLex term index. All terms whose first word starts with the <b>string</b> parameter are returned in an XML structure. The Content-Type of the response is <b>text/xml</b>, and the encoding is <b>UTF-8</b>.
  
The following example shows the response to a GET with the <b>string</b> parameter equal to <b><tt>inter</tt></b>:
+
The following example shows the response to a GET with the <b>string</b> parameter equal to <b><tt>low</tt></b>:
  
 
<pre>
 
<pre>
 
<RadLexTerms>
 
<RadLexTerms>
<term id="RL196">interatrial septum</term>  
+
<term id="RID10629">low spatial resolution reconstruction algorithm</term>  
<term id="RL328">intercostal arteries</term>  
+
<term id="RID10945">low energy parallel hole ultra-high resolution</term>  
<term id="RL449">intercostal muscles</term>  
+
<term id="RID10948">low energy parallel hole high sensitivity</term>  
<term id="RL459">intercostal nerves</term>  
+
<term id="RID10947">low energy parallel hole general purpose</term>  
<term id="RL1316">intermediate perceptual difficulty</term>  
+
<term id="RID10946">low energy parallel hole high-resolution</term>  
<term id="RL1320">intermediate analytical difficulty</term>  
+
<term id="RID10630">low frequency reconstruction algorithm</term>  
<term id="RL1057">intermediate cell type</term>  
+
<term id="RID10944">low energy parallel hole collimator</term>  
<term id="RL782">intermediate signal</term>  
+
<term id="RID11415">low-pass frequency filter artifact</term>
<term id="RL625">intermediate</term>  
+
<term id="RID3336">low-flow vascular malformation</term>
<term id="RL447">internal abdominal oblique muscle</term>  
+
<term id="RID10628">low spatial resolution process</term>
<term id="RL392">internal mammary lymph nodes</term>  
+
<term id="RID11047">low profile balloon catheter</term>
<term id="RL1095">interstitial pneumonias</term>  
+
<term id="RID1716">low anterior resection</term>
<term id="RL197">interventricular septum</term>  
+
<term id="RID6050">low signal intensity</term>  
 +
<term id="RID11051">low-pressure balloon</term>  
 +
<term id="RID10918">low intensity pulse</term>  
 +
<term id="RID6039">low attenuation</term>
 +
<term id="RID12852">low iodine diet</term>
 +
<term id="RID5677">low grade</term>
 +
<term id="RID7737">lower posterior cervical triangle lymph nod e</term>
 +
<term id="RID7263">lower lateral cutaneous nerve of arm</term>
 +
<term id="RID7847">lower band of cruciform ligament</term>
 +
<term id="RID105">lower esophageal muscular ring</term>
 +
<term id="RID107">lower esophageal mucosal ring</term>
 +
<term id="RID1471">lower paratracheal lymph node</term>
 +
<term id="RID103">lower esophageal sphincter</term>
 +
<term id="RID1315">lower lobe of right lung</term>
 +
<term id="RID1338">lower lobe of left lung</term>
 +
<term id="RID5026">lower esophageal ring</term>
 +
<term id="RID207">lower pole of kidney</term>
 +
<term id="RID2638">lower extremity</term>
 +
<term id="RID1354">lower lung zone</term>  
 +
<term id="RID7216">lower trunk</term>  
 +
<term id="RID9930">lower lip</term>  
 
</RadLexTerms>
 
</RadLexTerms>
 
</pre>
 
</pre>
 
Note, the result shown above is based on a previous form of the RadLex ontology whose <b>id</b> values were different from those used today. The format of the result, however, correctly illustrates how the matching terms are returned.
 
  
 
The order of the returned terms is as follows:
 
The order of the returned terms is as follows:

Revision as of 22:41, 9 February 2009

This article describes the MIRC RadLex Servlet which provides access to MIRC's RadLex term index. The intended audience for this article is software developers who want to provide a suggest-like user interface for web pages or other applications.

The servlet is a RESTful web service which is accessed by an HTTP GET in the form:

http://ip:port/mirc/radlex?key=string

where string is a set of URL-encoded characters. The string parameter is used as an index into the RadLex term index. All terms whose first word starts with the string parameter are returned in an XML structure. The Content-Type of the response is text/xml, and the encoding is UTF-8.

The following example shows the response to a GET with the string parameter equal to low:

<RadLexTerms>
	<term id="RID10629">low spatial resolution reconstruction algorithm</term> 
	<term id="RID10945">low energy parallel hole ultra-high resolution</term> 
	<term id="RID10948">low energy parallel hole high sensitivity</term> 
	<term id="RID10947">low energy parallel hole general purpose</term> 
	<term id="RID10946">low energy parallel hole high-resolution</term> 
	<term id="RID10630">low frequency reconstruction algorithm</term> 
	<term id="RID10944">low energy parallel hole collimator</term> 
	<term id="RID11415">low-pass frequency filter artifact</term> 
	<term id="RID3336">low-flow vascular malformation</term> 
	<term id="RID10628">low spatial resolution process</term> 
	<term id="RID11047">low profile balloon catheter</term> 
	<term id="RID1716">low anterior resection</term> 
	<term id="RID6050">low signal intensity</term> 
	<term id="RID11051">low-pressure balloon</term> 
	<term id="RID10918">low intensity pulse</term> 
	<term id="RID6039">low attenuation</term> 
	<term id="RID12852">low iodine diet</term> 
	<term id="RID5677">low grade</term> 
	<term id="RID7737">lower posterior cervical triangle lymph nod e</term> 
	<term id="RID7263">lower lateral cutaneous nerve of arm</term> 
	<term id="RID7847">lower band of cruciform ligament</term> 
	<term id="RID105">lower esophageal muscular ring</term> 
	<term id="RID107">lower esophageal mucosal ring</term> 
	<term id="RID1471">lower paratracheal lymph node</term> 
	<term id="RID103">lower esophageal sphincter</term> 
	<term id="RID1315">lower lobe of right lung</term> 
	<term id="RID1338">lower lobe of left lung</term> 
	<term id="RID5026">lower esophageal ring</term> 
	<term id="RID207">lower pole of kidney</term> 
	<term id="RID2638">lower extremity</term> 
	<term id="RID1354">lower lung zone</term> 
	<term id="RID7216">lower trunk</term> 
	<term id="RID9930">lower lip</term> 
</RadLexTerms>

The order of the returned terms is as follows:

  • Terms are in alphabetical order based on the first word of the term.
  • Terms with the same first word are in reverse order based on the length of the term (e.g., longest first).