Difference between revisions of "The MIRC RadLex Servlet"

From MircWiki
Jump to navigation Jump to search
(New page: This article describes the MIRC RadLex Servlet used to provide access to MIRC's RadLex term index. The intended audience for this article is software developers who want to provide a sugge...)
 
m (Protected "The MIRC RadLex Servlet" [edit=sysop:move=sysop])
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
This article describes the MIRC RadLex Servlet used to provide 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.
+
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:
 
The servlet is a RESTful web service which is accessed by an HTTP GET in the form:
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:
  
* Terms are iin alphabetical order based on the first word of the term.
+
* 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).
 
* Terms with the same first word are in reverse order based on the length of the term (e.g., longest first).

Latest revision as of 19:29, 31 July 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).