Project

General

Profile

« Previous | Next » 

Revision 2311

Added by Matt Jones over 20 years ago

Created a list of all of the servlet actions in the documentation and listed
all reuired and optional parameters for each action. These need to be
documented but at least the list is all in one place now.

View differences:

metacat.html
37 37
  and searching. 
38 38

  
39 39
  <P> <img alt="Structural diagram of Metacat architecture" src="metacat.gif">
40
  </p>
41
  <p>
42
	Metacat provides several means of access for communicating with the
43
	server to access and submit metadata and data.  First, users can
44
	access the flexible web user interface.  Second, the servlet can be
45
	queried using basic HTML forms.  Third, a 
46
	<a href="./clientapi.html">client API</a> exists for 
47
	writing software for accessing the server's contents.
48
  </p>
49
  <p>	
50
	When accessing the servlet interface either through 'GET' or 'POST'
51
	HTTP requests, the request is directed to the appropriate handler based
52
	on an 'action' parameter in the request.  For example, using the 
53
	parameter 'action=getversion' one could construct an HTTP GET
54
	request to retrive the Metacat version string:<br>
55
  	<code>http://some.metacat.host/context/metacat?action=getversion</code>
56
  </p>
57
  <p>
58
	The complete list of "actions" which can be used in request to Metacat 
59
	along with the additional parameters associated with each action are
60
	as follows.
61
  </p>
62
  <p>	Primary actions for the most important features:<br>
63
  <ul>
64
      <li><code>action=login</code>
65
          <ul>
66
          <li><code>username</code></li>
67
          <li><code>password</code></li>
68
          </ul>
69
      </li>
70
      <li><code>action=logout</code>
71
      </li>
72
      <li><code>action=query</code>
73
          <ul>
74
          <li><code>meta_file_id</code></li>
75
          <li><code>returndoctype</code></li>
76
          <li><code>filterdoctype</code></li>
77
          <li><code>returnfield</code></li>
78
          <li><code>owner</code></li>
79
          <li><code>site</code></li>
80
          <li><code>operator</code></li>
81
          <li><code>casesensitive</code></li>
82
          <li><code>searchmode</code></li>
83
          <li><code>anyfield</code></li>
84
          <li><code>sessionid</code></li>
85
          <li>Any other parameter passed in will be interpreted as a query
86
              term unless it is listed in the 'query.ignored.params'
87
              property in metacat.properties</li>
88
          </ul>
89
      </li>
90
      <li><code>action=squery</code>
91
          <ul>
92
          <li><code>query</code></li>
93
          <li><code>qformat</code></li>
94
          </ul>
95
      </li>
96
      <li><code>action=read</code>
97
          <ul>
98
          <li><code>docid</code></li>
99
          <li><code>qformat</code></li>
100
          </ul>
101
      </li>
102
      <li><code>action=insert</code>
103
          <ul>
104
          <li><code>docid</code></li>
105
          <li><code>doctext</code></li>
106
          <li><code>dtdtext</code></li>
107
          </ul>
108
      </li>
109
      <li><code>action=update</code>
110
          <ul>
111
          <li><code>docid</code></li>
112
          <li><code>doctext</code></li>
113
          <li><code>dtdtext</code></li>
114
          </ul>
115
      </li>
116
      <li><code>action=delete</code>
117
          <ul>
118
          <li><code>docid</code></li>
119
          </ul>
120
      </li>
121
  </ul>
122
	Actions for less important features:<br>
123
  <ul>
124
      <li><code>action=export</code>
125
          <ul>
126
          <li><code>docid</code></li>
127
          </ul>
128
      </li>
129
      <li><code>action=readinlinedata</code>
130
          <ul>
131
          <li><code>inlinedataid</code></li>
132
          </ul>
133
      </li>
134
      <li><code>action=validate</code>
135
          <ul>
136
          <li><code>valtext</code></li>
137
          <li><code>docid</code></li>
138
          </ul>
139
      </li>
140
      <li><code>action=setaccess</code>
141
          <ul>
142
          <li><code>docid</code></li>
143
          <li><code>principal</code></li>
144
          <li><code>permission</code></li>
145
          <li><code>permType</code></li>
146
          <li><code>permOrder</code></li>
147
          <li><code>principal</code></li>
148
          </ul>
149
      </li>
150
      <li><code>action=getaccesscontrol</code>
151
          <ul>
152
          <li><code>docid</code></li>
153
          </ul>
154
      </li>
155
      <li><code>action=getprincipals</code>
156
      </li>
157
      <li><code>action=getdoctypes</code>
158
      </li>
159
      <li><code>action=getdtdschema</code>
160
          <ul>
161
          <li><code>doctype</code></li>
162
          </ul>
163
      </li>
164
      <li><code>action=getlastdocid</code>
165
          <ul>
166
          <li><code>scope</code></li>
167
          <li><code>username</code></li>
168
          </ul>
169
      </li>
170
      <li><code>action=getrevisionanddoctype</code>
171
          <ul>
172
          <li><code>docid</code></li>
173
          </ul>
174
      </li>
175
      <li><code>action=getversion</code>
176
      </li>
177
      <li><code>action=getlog</code>
178
          <ul>
179
          <li><code>ipaddress</code></li>
180
          <li><code>principal</code></li>
181
          <li><code>docid</code></li>
182
          <li><code>event</code></li>
183
          <li><code>start</code></li>
184
          <li><code>end</code></li>
185
          </ul>
186
      </li>
187
      <li><code>action=buildIndex</code>
188
          <ul>
189
          <li><code>docid</code></li>
190
          </ul>
191
      </li>
192
      <li><code>action=shrink</code>
193
      </li>
194
  </ul>
195
  </p>
196

  
40 197
  <br>
41 198
  <a href="./domapi.html">Back</a> | <a href="./metacattour.html">Home</a> | 
42 199
  <a href="./metacatdb.html">Next</a>

Also available in: Unified diff