diff options
Diffstat (limited to 'framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/types/resources/ResourceDecorator.java')
| -rw-r--r-- | framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/types/resources/ResourceDecorator.java | 270 |
1 files changed, 0 insertions, 270 deletions
diff --git a/framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/types/resources/ResourceDecorator.java b/framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/types/resources/ResourceDecorator.java deleted file mode 100644 index 3806cf2c..00000000 --- a/framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/types/resources/ResourceDecorator.java +++ /dev/null @@ -1,270 +0,0 @@ -/* - * Licensed to the Apache Software Foundation (ASF) under one or more - * contributor license agreements. See the NOTICE file distributed with - * this work for additional information regarding copyright ownership. - * The ASF licenses this file to You under the Apache License, Version 2.0 - * (the "License"); you may not use this file except in compliance with - * the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - * - */ -package org.apache.tools.ant.types.resources; - -import java.io.IOException; -import java.io.InputStream; -import java.io.OutputStream; -import java.util.Stack; - -import org.apache.tools.ant.BuildException; -import org.apache.tools.ant.Project; -import org.apache.tools.ant.types.Reference; -import org.apache.tools.ant.types.Resource; -import org.apache.tools.ant.types.ResourceCollection; - -/** - * Abstract class that delegates all reading methods of Resource to - * its wrapped resource and deals with reference handling. - * - * <p>Overwrites all setters to throw exceptions.</p> - * - * @since Ant 1.8.0 - */ -public abstract class ResourceDecorator extends Resource { - - private Resource resource; - - /** no arg constructor */ - protected ResourceDecorator() { - } - - /** - * Constructor with another resource to wrap. - * @param other the resource to wrap. - */ - protected ResourceDecorator(ResourceCollection other) { - addConfigured(other); - } - - /** - * Sets the resource to wrap using a single-element collection. - * @param a the resource to wrap as a single element Resource collection. - */ - public final void addConfigured(ResourceCollection a) { - checkChildrenAllowed(); - if (resource != null) { - throw new BuildException("you must not specify more than one" - + " resource"); - } - if (a.size() != 1) { - throw new BuildException("only single argument resource collections" - + " are supported"); - } - setChecked(false); - resource = a.iterator().next(); - } - - /** - * Get the name of the resource. - * @return the name of the wrapped resource. - */ - public String getName() { - return getResource().getName(); - } - - /** - * The exists attribute tells whether a file exists. - * @return true if this resource exists. - */ - public boolean isExists() { - return getResource().isExists(); - } - - /** - * Tells the modification time in milliseconds since 01.01.1970 . - * - * @return 0 if the resource does not exist to mirror the behavior - * of {@link java.io.File File}. - */ - public long getLastModified() { - return getResource().getLastModified(); - } - - /** - * Tells if the resource is a directory. - * @return boolean flag indicating if the resource is a directory. - */ - public boolean isDirectory() { - return getResource().isDirectory(); - } - - /** - * Get the size of this Resource. - * @return the size, as a long, 0 if the Resource does not exist (for - * compatibility with java.io.File), or UNKNOWN_SIZE if not known. - */ - public long getSize() { - return getResource().getSize(); - } - - /** - * Get an InputStream for the Resource. - * @return an InputStream containing this Resource's content. - * @throws IOException if unable to provide the content of this - * Resource as a stream. - * @throws UnsupportedOperationException if InputStreams are not - * supported for this Resource type. - */ - public InputStream getInputStream() throws IOException { - return getResource().getInputStream(); - } - - /** - * Get an OutputStream for the Resource. - * @return an OutputStream to which content can be written. - * @throws IOException if unable to provide the content of this - * Resource as a stream. - * @throws UnsupportedOperationException if OutputStreams are not - * supported for this Resource type. - */ - public OutputStream getOutputStream() throws IOException { - return getResource().getOutputStream(); - } - - /** - * Fulfill the ResourceCollection contract. - * @return whether this Resource is a FileProvider. - */ - public boolean isFilesystemOnly() { - return as(FileProvider.class) != null; - } - - /** - * Overrides the base version. - * @param r the Reference to set. - */ - public void setRefid(Reference r) { - if (resource != null) { - throw noChildrenAllowed(); - } - super.setRefid(r); - } - - /** - * {@inheritDoc} - */ - public <T> T as(Class<T> clazz) { - return getResource().as(clazz); - } - - /** - * {@inheritDoc} - */ - public int compareTo(Resource other) { - if (other == this) { - return 0; - } - if (other instanceof ResourceDecorator) { - return getResource().compareTo( - ((ResourceDecorator) other).getResource()); - } - return getResource().compareTo(other); - } - - /** - * Get the hash code for this Resource. - * @return hash code as int. - */ - public int hashCode() { - return (getClass().hashCode() << 4) | getResource().hashCode(); - } - - /** - * De-references refids if any, ensures a wrapped resource has - * been specified. - */ - protected final Resource getResource() { - if (isReference()) { - return (Resource) getCheckedRef(); - } - if (resource == null) { - throw new BuildException("no resource specified"); - } - dieOnCircularReference(); - return resource; - } - - /** - * {@inheritDoc} - */ - protected void dieOnCircularReference(final Stack<Object> stack, - final Project project) - throws BuildException { - if (isChecked()) { - return; - } - if (isReference()) { - super.dieOnCircularReference(stack, project); - } else { - pushAndInvokeCircularReferenceCheck(resource, stack, project); - setChecked(true); - } - } - - // disable modification - - /** - * Overridden, not allowed to set the name of the resource. - * @param name not used. - * @throws BuildException always. - */ - public void setName(String name) throws BuildException { - throw new BuildException("you can't change the name of a " - + getDataTypeName()); - } - - /** - * Set the exists attribute. - * @param exists if true, this resource exists. - */ - public void setExists(boolean exists) { - throw new BuildException("you can't change the exists state of a " - + getDataTypeName()); - } - - /** - * Override setLastModified. - * @param lastmodified not used. - * @throws BuildException always. - */ - public void setLastModified(long lastmodified) throws BuildException { - throw new BuildException("you can't change the timestamp of a " - + getDataTypeName()); - } - - /** - * Override setDirectory. - * @param directory not used. - * @throws BuildException always. - */ - public void setDirectory(boolean directory) throws BuildException { - throw new BuildException("you can't change the directory state of a " - + getDataTypeName()); - } - - /** - * Override setSize. - * @param size not used. - * @throws BuildException always. - */ - public void setSize(long size) throws BuildException { - throw new BuildException("you can't change the size of a " - + getDataTypeName()); - } -} |