001: /*
002: * FactoryContext.java December 2002
003: *
004: * Copyright (C) 2002, Niall Gallagher <niallg@users.sf.net>
005: *
006: * This library is free software; you can redistribute it and/or
007: * modify it under the terms of the GNU Lesser General Public
008: * License as published by the Free Software Foundation.
009: *
010: * This library is distributed in the hope that it will be useful,
011: * but WITHOUT ANY WARRANTY; without even the implied warranty of
012: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
013: * GNU Lesser General Public License for more details.
014: *
015: * You should have received a copy of the GNU Lesser General
016: * Public License along with this library; if not, write to the
017: * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
018: * Boston, MA 02111-1307 USA
019: */
020:
021: package simple.http.serve;
022:
023: import java.io.IOException;
024: import java.io.File;
025:
026: /**e
027: * The <code>FactoryContext</code> is a context implementation that can
028: * be used to serve dynamic <code>Content</code> objects. This uses a
029: * <code>ContentFactory</code> implementation to produce instances
030: * from the <code>getInstance</code> method. This should be used if
031: * content other than static files needs to be served from the
032: * context. Also, this can be used as a caching implementation by
033: * using the <code>FileContentFactory</code> object for static files.
034: *
035: * @author Niall Gallagher
036: *
037: * @see simple.http.serve.CacheContext
038: */
039: public class FactoryContext extends FileContext {
040:
041: /**
042: * This is used to acquire <code>Content</code> implementations.
043: */
044: protected ContentFactory factory;
045:
046: /**
047: * Constructor for the <code>FactoryContext</code>. This will
048: * produce dynamic <code>Content</code> implementations. The
049: * objects produced by the <code>getContent</code> method are
050: * created using a <code>ContentFactory</code>. This loads all
051: * configuration files from the current working directory.
052: *
053: * @param factory used to produce dynamic content objects
054: */
055: public FactoryContext(ContentFactory factory) {
056: this (factory, new File("."));
057: }
058:
059: /**
060: * Constructor for the <code>FactoryContext</code>. This will
061: * produce dynamic <code>Content</code> implementations. The
062: * objects produced by the <code>getContent</code> method are
063: * created using a <code>ContentFactory</code>. This loads
064: * all files and configuration from the specified path.
065: *
066: * @param base the OS specific base path for this instance
067: * @param factory used to produce dynamic content objects
068: */
069: public FactoryContext(ContentFactory factory, File base) {
070: this (factory, base, base);
071: }
072:
073: /**
074: * Constructor for the <code>FactoryContext</code>. This will
075: * produce dynamic <code>Content</code> implementations. The
076: * objects produced by the <code>getContent</code> method are
077: * created using a <code>ContentFactory</code>. This loads
078: * all files from the specified base path. Configuration can
079: * be loaded from the file range provided.
080: *
081: * @param base the OS specific base path for this instance
082: * @param factory used to produce dynamic content objects
083: * @param path this is the directory used for configuration
084: */
085: public FactoryContext(ContentFactory factory, File base, File path) {
086: this (factory, base, new File[] { path });
087: }
088:
089: /**
090: * Constructor for the <code>FactoryContext</code>. This will
091: * produce dynamic <code>Content</code> implementations. The
092: * objects produced by the <code>getContent</code> method are
093: * created using a <code>ContentFactory</code>. This loads
094: * all files from the specified base path. Configuration can
095: * be loaded from the file range provided.
096: *
097: * @param base the OS specific base path for this instance
098: * @param factory used to produce dynamic content objects
099: * @param list this is the range searched for configuration
100: */
101: public FactoryContext(ContentFactory factory, File base, File[] list) {
102: super (base, list);
103: this .factory = factory;
104: }
105:
106: /**
107: * This creates instances of the <code>Content</code> object using
108: * the issued <code>ContentFactory</code>. This will initially
109: * attempt to acquire the content instance using the provided
110: * factory. However, if this fails the super class method is used.
111: *
112: * @param target the request URI used to reference the resource
113: *
114: * @throws IOException this is thrown if there is an I/O problem
115: */
116: public Content getContent(String target) throws IOException {
117: try {
118: return factory.getInstance(this , target);
119: } catch (ContentException e) {
120: return super.getContent(target);
121: }
122: }
123: }
|