/*
* Copyright (C) 2009 eXo Platform SAS.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.exoplatform.commons.xml;
import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.URL;
/**
* @author <a href="mailto:julien.viet@exoplatform.com">Julien Viet</a>
* @version $Revision$
*/
public abstract class DocumentSource {
/** Some kind of identifier for error reporting. */
private String identifier;
private DocumentSource(String identifier) {
if (identifier == null) {
throw new NullPointerException("An identifier must be provided");
}
this.identifier = identifier;
}
public String getIdentifier() {
return identifier;
}
/**
* Returns a new {@link InputStream}. When called multiple times, returns distinct
* {@link InputStream} that can be read independently.
*
* @return a new {@link InputStream}
* @throws IOException
*/
public abstract InputStream getStream() throws IOException;
public static DocumentSource create(String identifier, final byte[] bytes) {
return new DocumentSource(identifier) {
@Override
public InputStream getStream() throws IOException {
return new ByteArrayInputStream(bytes);
}
};
}
public static DocumentSource create(final URL url) {
return new DocumentSource(url.toString()) {
@Override
public InputStream getStream() throws IOException {
return url.openStream();
}
};
}
}