1 |
5020
|
costa
|
/**
|
2 |
|
|
* '$RCSfile$'
|
3 |
|
|
* Copyright: 2009 University of New Mexico and the
|
4 |
|
|
* Regents of the University of California
|
5 |
|
|
*
|
6 |
|
|
* '$Author: costa $'
|
7 |
|
|
* '$Date: 2009-07-27 17:47:44 -0400 (Mon, 27 Jul 2009) $'
|
8 |
|
|
* '$Revision: 4999 $'
|
9 |
|
|
*
|
10 |
|
|
* This program is free software; you can redistribute it and/or modify
|
11 |
|
|
* it under the terms of the GNU General Public License as published by
|
12 |
|
|
* the Free Software Foundation; either version 2 of the License, or
|
13 |
|
|
* (at your option) any later version.
|
14 |
|
|
*
|
15 |
|
|
* This program is distributed in the hope that it will be useful,
|
16 |
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
17 |
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
18 |
|
|
* GNU General Public License for more details.
|
19 |
|
|
*
|
20 |
|
|
* You should have received a copy of the GNU General Public License
|
21 |
|
|
* along with this program; if not, write to the Free Software
|
22 |
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
23 |
|
|
*
|
24 |
|
|
* Additional Copyright 2006 OCLC, Online Computer Library Center
|
25 |
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
26 |
|
|
* you may not use this file except in compliance with the License.
|
27 |
|
|
* You may obtain a copy of the License at
|
28 |
|
|
*
|
29 |
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
30 |
|
|
*
|
31 |
|
|
* Unless required by applicable law or agreed to in writing, software
|
32 |
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
33 |
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
34 |
|
|
* See the License for the specific language governing permissions and
|
35 |
|
|
* limitations under the License.
|
36 |
|
|
*/
|
37 |
|
|
|
38 |
|
|
package edu.ucsb.nceas.metacat.oaipmh.harvester;
|
39 |
|
|
|
40 |
|
|
import java.io.IOException;
|
41 |
|
|
import java.net.URLEncoder;
|
42 |
|
|
|
43 |
|
|
import javax.xml.parsers.ParserConfigurationException;
|
44 |
|
|
import javax.xml.transform.TransformerException;
|
45 |
|
|
import org.xml.sax.SAXException;
|
46 |
|
|
|
47 |
|
|
|
48 |
|
|
/**
|
49 |
|
|
* This class represents an ListRecords response on either the server or on the
|
50 |
|
|
* client
|
51 |
|
|
*
|
52 |
|
|
* @author Jeffrey A. Young, OCLC Online Computer Library Center
|
53 |
|
|
*/
|
54 |
|
|
public class ListRecords extends HarvesterVerb {
|
55 |
|
|
|
56 |
|
|
/**
|
57 |
|
|
* Mock object constructor (for unit testing purposes)
|
58 |
|
|
*/
|
59 |
|
|
public ListRecords() {
|
60 |
|
|
super();
|
61 |
|
|
}
|
62 |
|
|
|
63 |
|
|
|
64 |
|
|
/**
|
65 |
|
|
* Client-side ListRecords verb constructor
|
66 |
|
|
*
|
67 |
|
|
* @param baseURL
|
68 |
|
|
* the baseURL of the server to be queried
|
69 |
|
|
* @exception MalformedURLException
|
70 |
|
|
* the baseURL is bad
|
71 |
|
|
* @exception SAXException
|
72 |
|
|
* the xml response is bad
|
73 |
|
|
* @exception IOException
|
74 |
|
|
* an I/O error occurred
|
75 |
|
|
*/
|
76 |
|
|
public ListRecords(String baseURL, String from, String until,
|
77 |
|
|
String metadataPrefix, String setSpec)
|
78 |
|
|
throws IOException, ParserConfigurationException,
|
79 |
|
|
SAXException, TransformerException {
|
80 |
|
|
super(getRequestURL(baseURL, from, until, metadataPrefix, setSpec));
|
81 |
|
|
}
|
82 |
|
|
|
83 |
|
|
|
84 |
|
|
/**
|
85 |
|
|
* Client-side ListRecords verb constructor (resumptionToken version)
|
86 |
|
|
*
|
87 |
|
|
* @param baseURL
|
88 |
|
|
* @param resumptionToken
|
89 |
|
|
* @throws IOException
|
90 |
|
|
* @throws ParserConfigurationException
|
91 |
|
|
* @throws SAXException
|
92 |
|
|
* @throws TransformerException
|
93 |
|
|
*/
|
94 |
|
|
public ListRecords(String baseURL, String resumptionToken)
|
95 |
|
|
throws IOException, ParserConfigurationException, SAXException,
|
96 |
|
|
TransformerException {
|
97 |
|
|
super(getRequestURL(baseURL, resumptionToken));
|
98 |
|
|
}
|
99 |
|
|
|
100 |
|
|
|
101 |
|
|
/**
|
102 |
|
|
* Get the oai:resumptionToken from the response
|
103 |
|
|
*
|
104 |
|
|
* @return the oai:resumptionToken value
|
105 |
|
|
* @throws TransformerException
|
106 |
|
|
* @throws NoSuchFieldException
|
107 |
|
|
*/
|
108 |
|
|
public String getResumptionToken() throws TransformerException,
|
109 |
|
|
NoSuchFieldException {
|
110 |
|
|
String schemaLocation = getSchemaLocation();
|
111 |
|
|
if (schemaLocation.indexOf(SCHEMA_LOCATION_V2_0) != -1) {
|
112 |
|
|
return getSingleString("/oai20:OAI-PMH/oai20:ListRecords/oai20:resumptionToken");
|
113 |
|
|
}
|
114 |
|
|
else {
|
115 |
|
|
throw new NoSuchFieldException(schemaLocation);
|
116 |
|
|
}
|
117 |
|
|
}
|
118 |
|
|
|
119 |
|
|
|
120 |
|
|
/**
|
121 |
|
|
* Construct the query portion of the http request
|
122 |
|
|
*
|
123 |
|
|
* @return a String containing the query portion of the http request
|
124 |
|
|
*/
|
125 |
|
|
private static String getRequestURL(String baseURL, String from,
|
126 |
|
|
String until, String metadataPrefix,
|
127 |
|
|
String setSpec)
|
128 |
|
|
{
|
129 |
|
|
StringBuffer requestURL = new StringBuffer(baseURL);
|
130 |
|
|
requestURL.append("?verb=ListRecords");
|
131 |
|
|
if (from != null)
|
132 |
|
|
requestURL.append("&from=").append(from);
|
133 |
|
|
if (until != null)
|
134 |
|
|
requestURL.append("&until=").append(until);
|
135 |
|
|
if (setSpec != null)
|
136 |
|
|
requestURL.append("&set=").append(setSpec);
|
137 |
|
|
requestURL.append("&metadataPrefix=").append(metadataPrefix);
|
138 |
|
|
return requestURL.toString();
|
139 |
|
|
}
|
140 |
|
|
|
141 |
|
|
|
142 |
|
|
/**
|
143 |
|
|
* Construct the query portion of the http request (resumptionToken version)
|
144 |
|
|
*
|
145 |
|
|
* @param baseURL
|
146 |
|
|
* @param resumptionToken
|
147 |
|
|
* @return
|
148 |
|
|
*/
|
149 |
|
|
@SuppressWarnings("deprecation")
|
150 |
|
|
private static String getRequestURL(String baseURL, String resumptionToken) {
|
151 |
|
|
StringBuffer requestURL = new StringBuffer(baseURL);
|
152 |
|
|
requestURL.append("?verb=ListRecords");
|
153 |
|
|
requestURL.append("&resumptionToken=").append(
|
154 |
|
|
URLEncoder.encode(resumptionToken));
|
155 |
|
|
return requestURL.toString();
|
156 |
|
|
}
|
157 |
|
|
}
|