Java tutorial
/** * Copyright 2009, 2010 The Regents of the University of California * Licensed under the Educational Community 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.osedu.org/licenses/ECL-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.opencastproject.composer.api; import org.apache.commons.io.IOUtils; import java.io.InputStream; import java.io.StringWriter; import java.io.Writer; import javax.xml.bind.JAXBContext; import javax.xml.bind.JAXBException; import javax.xml.bind.Marshaller; import javax.xml.bind.Unmarshaller; import javax.xml.transform.stream.StreamSource; /** * Provides a mechanism to transform {@link EncodingProfile}s to and from xml. */ public final class EncodingProfileBuilder { /** The singleton instance for this factory */ private static EncodingProfileBuilder instance = null; protected JAXBContext jaxbContext = null; private EncodingProfileBuilder() throws JAXBException { StringBuilder sb = new StringBuilder(); sb.append("org.opencastproject.composer.api"); jaxbContext = JAXBContext.newInstance(sb.toString(), EncodingProfileBuilder.class.getClassLoader()); } /** * Returns an instance of the {@link EncodingProfileBuilder}. * * @return a factory */ public static EncodingProfileBuilder getInstance() { if (instance == null) { try { instance = new EncodingProfileBuilder(); } catch (JAXBException e) { throw new IllegalStateException(e.getLinkedException() != null ? e.getLinkedException() : e); } } return instance; } /** * Loads an encoding profile from the given input stream. * * @param in * the input stream * @return the encoding profile * @throws Exception * if creating the profile fails */ public EncodingProfile parseProfile(InputStream in) throws Exception { Unmarshaller unmarshaller = jaxbContext.createUnmarshaller(); try { return unmarshaller.unmarshal(new StreamSource(in), EncodingProfileImpl.class).getValue(); } finally { IOUtils.closeQuietly(in); } } /** * Loads an encoding profile from the xml fragement. * * @param in * xml stream of the profile * @return the profile * @throws Exception * if creating the profile fails */ public EncodingProfile parseProfile(String in) throws Exception { InputStream is = null; try { is = IOUtils.toInputStream(in, "UTF-8"); return parseProfile(is); } finally { IOUtils.closeQuietly(is); } } /** * Loads an encoding profile list from the given input stream. * * @param in * the input stream * @return the encoding profile list * @throws Exception * if creating the profile list fails */ public EncodingProfileList parseProfileList(InputStream in) throws Exception { Unmarshaller unmarshaller = jaxbContext.createUnmarshaller(); try { return unmarshaller.unmarshal(new StreamSource(in), EncodingProfileList.class).getValue(); } finally { IOUtils.closeQuietly(in); } } /** * Loads an encoding profile from the xml stream. * * @param in * xml stream of the profile list * @return the profile list * @throws Exception * if creating the profile list fails */ public EncodingProfileList parseProfileList(String in) throws Exception { InputStream is = null; try { is = IOUtils.toInputStream(in, "UTF-8"); return parseProfileList(is); } finally { IOUtils.closeQuietly(is); } } /** * Serializes a profile to xml. * * @param profile * the profile to serialize * @return the xml fragment * @throws Exception */ public String toXml(EncodingProfile profile) throws Exception { Marshaller marshaller = jaxbContext.createMarshaller(); Writer writer = new StringWriter(); marshaller.marshal(profile, writer); return writer.toString(); } /** * Serializes a profile list to xml. * * @param profileList * the profile list to serialize * @return the xml fragment * @throws Exception */ public String toXml(EncodingProfileList profileList) throws Exception { Marshaller marshaller = jaxbContext.createMarshaller(); Writer writer = new StringWriter(); marshaller.marshal(profileList, writer); return writer.toString(); } }