001: /*
002: * This file is part of the Echo Web Application Framework (hereinafter "Echo").
003: * Copyright (C) 2002-2005 NextApp, Inc.
004: *
005: * Version: MPL 1.1/GPL 2.0/LGPL 2.1
006: *
007: * The contents of this file are subject to the Mozilla Public License Version
008: * 1.1 (the "License"); you may not use this file except in compliance with
009: * the License. You may obtain a copy of the License at
010: * http://www.mozilla.org/MPL/
011: *
012: * Software distributed under the License is distributed on an "AS IS" basis,
013: * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
014: * for the specific language governing rights and limitations under the
015: * License.
016: *
017: * Alternatively, the contents of this file may be used under the terms of
018: * either the GNU General Public License Version 2 or later (the "GPL"), or
019: * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
020: * in which case the provisions of the GPL or the LGPL are applicable instead
021: * of those above. If you wish to allow use of your version of this file only
022: * under the terms of either the GPL or the LGPL, and not to allow others to
023: * use your version of this file under the terms of the MPL, indicate your
024: * decision by deleting the provisions above and replace them with the notice
025: * and other provisions required by the GPL or the LGPL. If you do not delete
026: * the provisions above, a recipient may use your version of this file under
027: * the terms of any one of the MPL, the GPL or the LGPL.
028: */
029:
030: package nextapp.echo2.webrender.service;
031:
032: import java.io.IOException;
033:
034: import nextapp.echo2.webrender.Connection;
035: import nextapp.echo2.webrender.Service;
036: import nextapp.echo2.webrender.util.Resource;
037:
038: /**
039: * A <code>Service</code> which renders a static binary resource.
040: */
041: public class StaticBinaryService implements Service {
042:
043: /**
044: * Creates a new <code>StaticBinaryService</code> based on the data in the
045: * specified <code>CLASSPATH</code> resource. A runtime exception will be
046: * thrown in the even the resource does not exist (it generally should not
047: * be caught).
048: *
049: * @param id the <code>Service</code> identifier
050: * @param contentType the content type
051: * @param resourceName the path to the content data in the
052: * <code>CLASSPATH</code>
053: * @return the created <code>StaticBinaryService</code>
054: */
055: public static StaticBinaryService forResource(String id,
056: String contentType, String resourceName) {
057: byte[] data = Resource.getResourceAsByteArray(resourceName);
058: return new StaticBinaryService(id, contentType, data);
059: }
060:
061: private String id;
062: private byte[] data;
063: private String contentType;
064:
065: /**
066: * Creates a new <code>StaticBinaryService</code>.
067: *
068: * @param id the <code>Service</code> identifier
069: * @param contentType the content type
070: * @param data the binary data
071: */
072: public StaticBinaryService(String id, String contentType,
073: byte[] data) {
074: super ();
075: this .id = id;
076: this .contentType = contentType;
077: this .data = data;
078: }
079:
080: /**
081: * @see nextapp.echo2.webrender.Service#getId()
082: */
083: public String getId() {
084: return id;
085: }
086:
087: /**
088: * @see nextapp.echo2.webrender.Service#getVersion()
089: */
090: public int getVersion() {
091: return 0;
092: }
093:
094: /**
095: * @see nextapp.echo2.webrender.Service#service(nextapp.echo2.webrender.Connection)
096: */
097: public void service(Connection conn) throws IOException {
098: try {
099: conn.getResponse().setContentType(contentType);
100: conn.getOutputStream().write(data);
101: } catch (IOException ex) {
102: // Internet Explorer appears to enjoy making half-hearted requests for images, wherein it resets the connection
103: // leaving us with an IOException. This exception is silently eaten.
104: // It would preferable to only ignore SocketExceptions, however the API documentation does not provide
105: // enough information to suggest that such a strategy would be adequate..
106: }
107: }
108: }
|