Classes in this File | Line Coverage | Branch Coverage | Complexity | ||||
EncoderRegistry |
|
| 0.0;0 |
1 | /* | |
2 | * Copyright 2003-2008 the original author or authors. | |
3 | * | |
4 | * Licensed under the Apache License, Version 2.0 (the "License"); | |
5 | * you may not use this file except in compliance with the License. | |
6 | * You may obtain a copy of the License at | |
7 | * | |
8 | * http://www.apache.org/licenses/LICENSE-2.0 | |
9 | * | |
10 | * Unless required by applicable law or agreed to in writing, software | |
11 | * distributed under the License is distributed on an "AS IS" BASIS, | |
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
13 | * See the License for the specific language governing permissions and | |
14 | * limitations under the License. | |
15 | * | |
16 | * You are receiving this code free of charge, which represents many hours of | |
17 | * effort from other individuals and corporations. As a responsible member | |
18 | * of the community, you are asked (but not required) to donate any | |
19 | * enhancements or improvements back to the community under a similar open | |
20 | * source license. Thank you. -TMN | |
21 | */ | |
22 | package groovyx.net.http; | |
23 | ||
24 | import groovy.lang.Closure; | |
25 | import groovy.lang.Writable; | |
26 | import groovy.xml.StreamingMarkupBuilder; | |
27 | import groovyx.net.http.HTTPBuilder.SendDelegate; | |
28 | ||
29 | import java.io.BufferedReader; | |
30 | import java.io.ByteArrayInputStream; | |
31 | import java.io.ByteArrayOutputStream; | |
32 | import java.io.IOException; | |
33 | import java.io.InputStream; | |
34 | import java.io.PrintWriter; | |
35 | import java.io.Reader; | |
36 | import java.io.StringWriter; | |
37 | import java.io.UnsupportedEncodingException; | |
38 | import java.nio.charset.Charset; | |
39 | import java.util.ArrayList; | |
40 | import java.util.HashMap; | |
41 | import java.util.List; | |
42 | import java.util.Map; | |
43 | ||
44 | import net.sf.json.JSON; | |
45 | import net.sf.json.JSONObject; | |
46 | import net.sf.json.groovy.JsonGroovyBuilder; | |
47 | ||
48 | import org.apache.http.HttpEntity; | |
49 | import org.apache.http.NameValuePair; | |
50 | import org.apache.http.client.entity.UrlEncodedFormEntity; | |
51 | import org.apache.http.entity.ByteArrayEntity; | |
52 | import org.apache.http.entity.InputStreamEntity; | |
53 | import org.apache.http.message.BasicNameValuePair; | |
54 | import org.codehaus.groovy.runtime.MethodClosure; | |
55 | ||
56 | ||
57 | /** | |
58 | * This factory (or registry) handles request body "encoding." This is not | |
59 | * to be confused with HTTP content-encoding header. When a | |
60 | * {@link SendDelegate#setBody(Object) body} is set from the builder, it is | |
61 | * processed based on the request content-type. For instance, if the body | |
62 | * is set to a map and the request cotnent-type is JSON, the map will be | |
63 | * transformed to a JSON Object. | |
64 | * | |
65 | * Most default encoders can handle a closure as a request body. In this | |
66 | * case, the closure is executed and a suitable 'builder' passed to the | |
67 | * closure that is used for constructing the content. In the case of | |
68 | * binary encoding this would be an OutputStream; for TEXT encoding it would | |
69 | * be a PrintWriter, and for XML it would be an already-bound | |
70 | * {@link StreamingMarkupBuilder}. | |
71 | */ | |
72 | 5 | public class EncoderRegistry { |
73 | ||
74 | 5 | Charset charset = Charset.defaultCharset(); |
75 | public void setCharset( String charset ) { | |
76 | 0 | this.charset = Charset.forName(charset); |
77 | 0 | } |
78 | ||
79 | /** | |
80 | * Default request encoder for a binary stream. Acceptable argument | |
81 | * types are: | |
82 | * <ul> | |
83 | * <li>InputStream</li> | |
84 | * <li>ByteArrayOutputStream</li> | |
85 | * <li>Closure</li> | |
86 | * </ul> | |
87 | * If a closure is given, it is executed with an OutputStream passed | |
88 | * as the single closure argument. Any data sent to the stream from the | |
89 | * body of the closure is used as the request content body. | |
90 | * @param data | |
91 | * @return | |
92 | * @throws UnsupportedEncodingException | |
93 | */ | |
94 | public HttpEntity encodeStream( Object data ) throws UnsupportedEncodingException { | |
95 | 0 | if ( data instanceof InputStream ) { |
96 | 0 | return new InputStreamEntity( (InputStream)data, -1 ); |
97 | } | |
98 | 0 | else if ( data instanceof ByteArrayInputStream ) { |
99 | 0 | ByteArrayInputStream in = ((ByteArrayInputStream)data); |
100 | 0 | return new InputStreamEntity( in, in.available() ); |
101 | } | |
102 | 0 | else if ( data instanceof ByteArrayOutputStream ) { |
103 | 0 | ByteArrayOutputStream out = ((ByteArrayOutputStream)data); |
104 | 0 | return new InputStreamEntity( new ByteArrayInputStream( |
105 | out.toByteArray()), out.size() ); | |
106 | } | |
107 | 0 | else if ( data instanceof Closure ) { |
108 | 0 | ByteArrayOutputStream out = new ByteArrayOutputStream(); |
109 | 0 | ((Closure)data).call( out ); // data is written to out |
110 | 0 | return new InputStreamEntity( new ByteArrayInputStream(out.toByteArray()), out.size() ); |
111 | } | |
112 | 0 | throw new IllegalArgumentException( "Don't know how to encode " + data + " as a byte stream" ); |
113 | } | |
114 | ||
115 | /** | |
116 | * Default handler used for a text content-type. Acceptable argument | |
117 | * types are: | |
118 | * <ul> | |
119 | * <li>Closure</li> | |
120 | * <li>Writable</li> | |
121 | * <li>Reader</li> | |
122 | * </ul> | |
123 | * For Closure argument, a {@link PrintWriter} is passed as the single | |
124 | * argument to the closure. Any data sent to the writer from the | |
125 | * closure will be sent to the request content body. | |
126 | * @param data | |
127 | * @return | |
128 | * @throws IOException | |
129 | */ | |
130 | public HttpEntity encodeText( Object data ) throws IOException { | |
131 | 0 | if ( data instanceof Closure ) { |
132 | 0 | StringWriter out = new StringWriter(); |
133 | 0 | PrintWriter writer = new PrintWriter( out ); |
134 | 0 | ((Closure)data).call( writer ); |
135 | 0 | writer.close(); |
136 | 0 | out.flush(); |
137 | 0 | data = out; |
138 | 0 | } |
139 | 0 | else if ( data instanceof Writable ) { |
140 | 0 | StringWriter out = new StringWriter(); |
141 | 0 | ((Writable)data).writeTo(out); |
142 | 0 | out.flush(); |
143 | 0 | data = out; |
144 | 0 | } |
145 | 0 | else if ( data instanceof Reader && ! (data instanceof BufferedReader) ) |
146 | 0 | data = new BufferedReader( (Reader)data ); |
147 | 0 | if ( data instanceof BufferedReader ) { |
148 | 0 | StringBuilder sb = new StringBuilder(); |
149 | 0 | BufferedReader reader = (BufferedReader)data; |
150 | 0 | String line = null; |
151 | 0 | while( (line = reader.readLine()) != null ) |
152 | 0 | sb.append( line ); |
153 | ||
154 | 0 | data = sb; |
155 | } | |
156 | // if data is a String, we are already covered. | |
157 | 0 | return createEntity( ContentType.TEXT, data.toString() ); |
158 | } | |
159 | ||
160 | /** | |
161 | * Set the request body as a url-encoded list of parameters. This is | |
162 | * typically used to simulate a HTTP form POST. | |
163 | * @param params | |
164 | * @return | |
165 | * @throws UnsupportedEncodingException | |
166 | */ | |
167 | public HttpEntity encodeForm( Map<String,Object> params ) throws UnsupportedEncodingException { | |
168 | 0 | List<NameValuePair> paramList = new ArrayList<NameValuePair>(); |
169 | ||
170 | 0 | for ( Map.Entry<String, Object> entry : params.entrySet() ) |
171 | 0 | paramList.add( new BasicNameValuePair(entry.getKey(), |
172 | entry.getValue().toString()) ); | |
173 | ||
174 | 0 | return new UrlEncodedFormEntity( paramList, charset.name() ); |
175 | } | |
176 | ||
177 | /** | |
178 | * Executes the given closure and passes a bound {@link StreamingMarkupBuilder}. | |
179 | * @param xmlBuilder | |
180 | * @return | |
181 | * @throws UnsupportedEncodingException | |
182 | */ | |
183 | public HttpEntity encodeXML( Closure xmlBuilder ) throws UnsupportedEncodingException { | |
184 | 0 | StreamingMarkupBuilder smb = new StreamingMarkupBuilder(); |
185 | 0 | String markup = smb.bind( xmlBuilder ).toString(); |
186 | 0 | return createEntity( ContentType.XML, markup); |
187 | } | |
188 | ||
189 | /** | |
190 | * Accepts a Map or a JavaBean object which is converted to JSON. If | |
191 | * a Closure is passed, it will be executed with a | |
192 | * {@link JsonGroovyBuilder} as the closure's delegate. The closure | |
193 | * must return the result of the outermost builder method call. | |
194 | * @param model | |
195 | * @return | |
196 | * @throws UnsupportedEncodingException | |
197 | */ | |
198 | @SuppressWarnings("unchecked") | |
199 | public HttpEntity encodeJSON( Object model ) throws UnsupportedEncodingException { | |
200 | JSON json; | |
201 | ||
202 | 0 | if ( model instanceof Map ) { |
203 | 0 | json = new JSONObject(); |
204 | 0 | ((JSONObject)json).putAll( (Map)model ); |
205 | } | |
206 | 0 | else if ( model instanceof Closure ) { |
207 | 0 | Closure closure = (Closure)model; |
208 | 0 | closure.setDelegate( new JsonGroovyBuilder() ); |
209 | 0 | json = (JSONObject)closure.call(); |
210 | 0 | } |
211 | 0 | else json = JSONObject.fromObject( model ); // Assume object is a JavaBean |
212 | ||
213 | 0 | return this.createEntity( ContentType.JSON, json.toString() ); |
214 | } | |
215 | ||
216 | protected HttpEntity createEntity( ContentType ct, String data ) throws UnsupportedEncodingException { | |
217 | 0 | ByteArrayEntity entity = new ByteArrayEntity( data.getBytes( charset ) ); |
218 | 0 | entity.setContentType( ct.toString() + "; charset=" + charset.name() ); |
219 | 0 | return entity; |
220 | } | |
221 | ||
222 | 5 | protected Map<String,Closure> registeredEncoders = buildDefaultEncoderMap(); |
223 | ||
224 | /** | |
225 | * Used to set an additional encoder for the given content type. The | |
226 | * Closure must return an {@link HttpEntity}. It will also usually | |
227 | * accept a single argument, which will be the value given in | |
228 | * {@link SendDelegate#setBody(Object)}. | |
229 | * @param contentType | |
230 | * @param closure | |
231 | */ | |
232 | public void register( String contentType, Closure closure ) { | |
233 | 0 | registeredEncoders.put( contentType, closure ); |
234 | 0 | } |
235 | ||
236 | /* Get the encoder for the given content-type. Not usually called | |
237 | * by the end-user. The HTTPBuilder will get the appropriate encoder | |
238 | * automatically in order to encode the request body data. | |
239 | * @param contentType | |
240 | * @return the encoder closure, or <code>null</code> if no encoder is | |
241 | * registered. | |
242 | */ | |
243 | 0 | Closure get( String contentType ) { return registeredEncoders.get(contentType); } |
244 | ||
245 | /** | |
246 | * Returns a map of default encoders. Override this method to change | |
247 | * what encoders are registered by default. You can of course call | |
248 | * <code>super.buildDefaultEncoderMap()</code> and then add or remove | |
249 | * from that result as well. | |
250 | */ | |
251 | protected Map<String,Closure> buildDefaultEncoderMap() { | |
252 | 5 | Map<String,Closure> encoders = new HashMap<String,Closure>(); |
253 | ||
254 | 5 | encoders.put( ContentType.BINARY.toString(), new MethodClosure(this,"encodeStream") ); |
255 | 5 | encoders.put( ContentType.TEXT.toString(), new MethodClosure( this, "encodeText" ) ); |
256 | 5 | encoders.put( ContentType.URLENC.toString(), new MethodClosure( this, "encodeForm" ) ); |
257 | ||
258 | 5 | Closure encClosure = new MethodClosure(this,"encodeXML"); |
259 | 20 | for ( String ct : ContentType.XML.getContentTypeStrings() ) |
260 | 15 | encoders.put( ct, encClosure ); |
261 | 5 | encoders.put( ContentType.HTML.toString(), encClosure ); |
262 | ||
263 | 5 | encClosure = new MethodClosure(this,"encodeJSON"); |
264 | 20 | for ( String ct : ContentType.JSON.getContentTypeStrings() ) |
265 | 15 | encoders.put( ct, encClosure ); |
266 | ||
267 | 5 | return encoders; |
268 | } | |
269 | } |