← Back to branch summary

~hjd/ubuntu/wily/xmlgraphics-commons/debian-merged

« back to all changes in this revision

Viewing changes to src/java/org/apache/xmlgraphics/io/ResourceResolver.java

  • Committer: Hans Joachim Desserud
  • Date: 2015-11-11 18:22:53 UTC
  • mfrom: (9.1.5 sid)
  • Revision ID: hans_joachim_desserud-20151111182253-zwi0frfm97j0wddn
  * Merge from Debian unstable.  Remaining changes:
    - d/control: Drop dependencies required for unit testing as they
      include libmockito-java which would pull maven into main, disable unit
      test execution.

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/java/org/apache/xmlgraphics/io/ResourceResolver.java
 
1
/*
 
2
 * Licensed to the Apache Software Foundation (ASF) under one or more
 
3
 * contributor license agreements.  See the NOTICE file distributed with
 
4
 * this work for additional information regarding copyright ownership.
 
5
 * The ASF licenses this file to You under the Apache License, Version 2.0
 
6
 * (the "License"); you may not use this file except in compliance with
 
7
 * the License.  You may obtain a copy of the License at
 
8
 *
 
9
 *      http://www.apache.org/licenses/LICENSE-2.0
 
10
 *
 
11
 * Unless required by applicable law or agreed to in writing, software
 
12
 * distributed under the License is distributed on an "AS IS" BASIS,
 
13
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 
14
 * See the License for the specific language governing permissions and
 
15
 * limitations under the License.
 
16
 */
 
17
 
 
18
/* $Id$ */
 
19
 
 
20
package org.apache.xmlgraphics.io;
 
21
 
 
22
import java.io.IOException;
 
23
import java.io.OutputStream;
 
24
import java.net.URI;
 
25
 
 
26
/**
 
27
 * Implementations of this resource resolver allow XGC users to control the URI resolution
 
28
 * mechanism. All resource and output stream acquisition goes through this when its implementation
 
29
 * is given to the org.apache.fop.apps.EnvironmentProfile.
 
30
 */
 
31
public interface ResourceResolver {
 
32
 
 
33
    /**
 
34
     * Get a resource given the URI pointing to said resource.
 
35
     *
 
36
     * @param uri the resource URI
 
37
     * @return the resource
 
38
     * @throws IOException if an I/O error occured during resource acquisition
 
39
     */
 
40
    Resource getResource(URI uri) throws IOException;
 
41
 
 
42
    /**
 
43
     * Gets an output stream of a given URI.
 
44
     *
 
45
     * @param uri the output stream URI
 
46
     * @return the output stream
 
47
     * @throws IOException if an I/O error occured while creating an output stream
 
48
     */
 
49
    OutputStream getOutputStream(URI uri) throws IOException;
 
50
 
 
51
}