001/**
002 * Licensed to the Apache Software Foundation (ASF) under one or more
003 * contributor license agreements.  See the NOTICE file distributed with
004 * this work for additional information regarding copyright ownership.
005 * The ASF licenses this file to You under the Apache License, Version 2.0
006 * (the "License"); you may not use this file except in compliance with
007 * the License.  You may obtain a copy of the License at
008 *
009 *      http://www.apache.org/licenses/LICENSE-2.0
010 *
011 * Unless required by applicable law or agreed to in writing, software
012 * distributed under the License is distributed on an "AS IS" BASIS,
013 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014 * See the License for the specific language governing permissions and
015 * limitations under the License.
016 */
017package org.apache.camel.model;
018
019import javax.xml.bind.annotation.XmlAccessType;
020import javax.xml.bind.annotation.XmlAccessorType;
021import javax.xml.bind.annotation.XmlAttribute;
022import javax.xml.bind.annotation.XmlElement;
023import javax.xml.bind.annotation.XmlElements;
024import javax.xml.bind.annotation.XmlRootElement;
025
026import org.apache.camel.Processor;
027import org.apache.camel.model.dataformat.ASN1DataFormat;
028import org.apache.camel.model.dataformat.AvroDataFormat;
029import org.apache.camel.model.dataformat.Base64DataFormat;
030import org.apache.camel.model.dataformat.BeanioDataFormat;
031import org.apache.camel.model.dataformat.BindyDataFormat;
032import org.apache.camel.model.dataformat.BoonDataFormat;
033import org.apache.camel.model.dataformat.CastorDataFormat;
034import org.apache.camel.model.dataformat.CryptoDataFormat;
035import org.apache.camel.model.dataformat.CsvDataFormat;
036import org.apache.camel.model.dataformat.CustomDataFormat;
037import org.apache.camel.model.dataformat.FhirJsonDataFormat;
038import org.apache.camel.model.dataformat.FhirXmlDataFormat;
039import org.apache.camel.model.dataformat.FlatpackDataFormat;
040import org.apache.camel.model.dataformat.GzipDataFormat;
041import org.apache.camel.model.dataformat.HL7DataFormat;
042import org.apache.camel.model.dataformat.HessianDataFormat;
043import org.apache.camel.model.dataformat.IcalDataFormat;
044import org.apache.camel.model.dataformat.JacksonXMLDataFormat;
045import org.apache.camel.model.dataformat.JaxbDataFormat;
046import org.apache.camel.model.dataformat.JibxDataFormat;
047import org.apache.camel.model.dataformat.JsonDataFormat;
048import org.apache.camel.model.dataformat.PGPDataFormat;
049import org.apache.camel.model.dataformat.ProtobufDataFormat;
050import org.apache.camel.model.dataformat.RssDataFormat;
051import org.apache.camel.model.dataformat.SerializationDataFormat;
052import org.apache.camel.model.dataformat.SoapJaxbDataFormat;
053import org.apache.camel.model.dataformat.StringDataFormat;
054import org.apache.camel.model.dataformat.SyslogDataFormat;
055import org.apache.camel.model.dataformat.TarFileDataFormat;
056import org.apache.camel.model.dataformat.ThriftDataFormat;
057import org.apache.camel.model.dataformat.TidyMarkupDataFormat;
058import org.apache.camel.model.dataformat.UniVocityCsvDataFormat;
059import org.apache.camel.model.dataformat.UniVocityFixedWidthDataFormat;
060import org.apache.camel.model.dataformat.UniVocityTsvDataFormat;
061import org.apache.camel.model.dataformat.XMLBeansDataFormat;
062import org.apache.camel.model.dataformat.XMLSecurityDataFormat;
063import org.apache.camel.model.dataformat.XStreamDataFormat;
064import org.apache.camel.model.dataformat.XmlJsonDataFormat;
065import org.apache.camel.model.dataformat.YAMLDataFormat;
066import org.apache.camel.model.dataformat.ZipDataFormat;
067import org.apache.camel.model.dataformat.ZipFileDataFormat;
068import org.apache.camel.processor.MarshalProcessor;
069import org.apache.camel.spi.DataFormat;
070import org.apache.camel.spi.Metadata;
071import org.apache.camel.spi.RouteContext;
072
073/**
074 * Marshals data into a specified format for transmission over a transport or component
075 *
076 * @version
077 */
078@Metadata(label = "eip,transformation")
079@XmlRootElement(name = "marshal")
080@XmlAccessorType(XmlAccessType.FIELD)
081public class MarshalDefinition extends NoOutputDefinition<MarshalDefinition> {
082
083    // TODO: Camel 3.0, ref attribute should be removed as CustomDataFormat is to be used instead
084
085    // cannot use @XmlElementRef as it doesn't allow optional properties
086    @XmlElements({
087        @XmlElement(required = false, name = "asn1", type = ASN1DataFormat.class),
088        @XmlElement(required = false, name = "avro", type = AvroDataFormat.class),
089        @XmlElement(required = false, name = "base64", type = Base64DataFormat.class),
090        @XmlElement(required = false, name = "beanio", type = BeanioDataFormat.class),
091        @XmlElement(required = false, name = "bindy", type = BindyDataFormat.class),
092        @XmlElement(required = false, name = "boon", type = BoonDataFormat.class),
093        @XmlElement(required = false, name = "castor", type = CastorDataFormat.class),
094        @XmlElement(required = false, name = "crypto", type = CryptoDataFormat.class),
095        @XmlElement(required = false, name = "csv", type = CsvDataFormat.class),
096        @XmlElement(required = false, name = "custom", type = CustomDataFormat.class),
097        @XmlElement(required = false, name = "fhirJson", type = FhirJsonDataFormat.class),
098        @XmlElement(required = false, name = "fhirXml", type = FhirXmlDataFormat.class),
099        @XmlElement(required = false, name = "flatpack", type = FlatpackDataFormat.class),
100        @XmlElement(required = false, name = "gzip", type = GzipDataFormat.class),
101        @XmlElement(required = false, name = "hessian", type = HessianDataFormat.class),
102        @XmlElement(required = false, name = "hl7", type = HL7DataFormat.class),
103        @XmlElement(required = false, name = "ical", type = IcalDataFormat.class),
104        @XmlElement(required = false, name = "jacksonxml", type = JacksonXMLDataFormat.class),
105        @XmlElement(required = false, name = "jaxb", type = JaxbDataFormat.class),
106        @XmlElement(required = false, name = "jibx", type = JibxDataFormat.class),
107        @XmlElement(required = false, name = "json", type = JsonDataFormat.class),
108        @XmlElement(required = false, name = "protobuf", type = ProtobufDataFormat.class),
109        @XmlElement(required = false, name = "rss", type = RssDataFormat.class),
110        @XmlElement(required = false, name = "secureXML", type = XMLSecurityDataFormat.class),
111        @XmlElement(required = false, name = "serialization", type = SerializationDataFormat.class),
112        @XmlElement(required = false, name = "soapjaxb", type = SoapJaxbDataFormat.class),
113        @XmlElement(required = false, name = "string", type = StringDataFormat.class),
114        @XmlElement(required = false, name = "syslog", type = SyslogDataFormat.class),
115        @XmlElement(required = false, name = "tarfile", type = TarFileDataFormat.class),
116        @XmlElement(required = false, name = "thrift", type = ThriftDataFormat.class),
117        @XmlElement(required = false, name = "tidyMarkup", type = TidyMarkupDataFormat.class),
118        @XmlElement(required = false, name = "univocity-csv", type = UniVocityCsvDataFormat.class),
119        @XmlElement(required = false, name = "univocity-fixed", type = UniVocityFixedWidthDataFormat.class),
120        @XmlElement(required = false, name = "univocity-tsv", type = UniVocityTsvDataFormat.class),
121        @XmlElement(required = false, name = "xmlBeans", type = XMLBeansDataFormat.class),
122        @XmlElement(required = false, name = "xmljson", type = XmlJsonDataFormat.class),
123        @XmlElement(required = false, name = "xstream", type = XStreamDataFormat.class),
124        @XmlElement(required = false, name = "pgp", type = PGPDataFormat.class),
125        @XmlElement(required = false, name = "yaml", type = YAMLDataFormat.class),
126        @XmlElement(required = false, name = "zip", type = ZipDataFormat.class),
127        @XmlElement(required = false, name = "zipFile", type = ZipFileDataFormat.class)}
128        )
129    private DataFormatDefinition dataFormatType;
130
131    @XmlAttribute
132    @Deprecated
133    private String ref;
134
135    public MarshalDefinition() {
136    }
137
138    public MarshalDefinition(DataFormatDefinition dataFormatType) {
139        this.dataFormatType = dataFormatType;
140    }
141
142    public MarshalDefinition(String ref) {
143        this.ref = ref;
144    }
145
146    @Override
147    public String toString() {
148        return "Marshal[" + description() + "]";
149    }
150
151    protected String description() {
152        return dataFormatType != null ? dataFormatType.toString() : "ref:" + ref;
153    }
154
155    @Override
156    public String getShortName() {
157        return "marshal";
158    }
159
160    @Override
161    public String getLabel() {
162        return "marshal[" + description() + "]";
163    }
164
165    public String getRef() {
166        return ref;
167    }
168
169    /**
170     * To refer to a custom data format to use as marshaller
171     *
172     * @deprecated use uri with ref:uri instead
173     */
174    @Deprecated
175    public void setRef(String ref) {
176        this.ref = ref;
177    }
178
179    public DataFormatDefinition getDataFormatType() {
180        return dataFormatType;
181    }
182
183    /**
184     * The data format to be used
185     */
186    public void setDataFormatType(DataFormatDefinition dataFormatType) {
187        this.dataFormatType = dataFormatType;
188    }
189
190    @Override
191    public Processor createProcessor(RouteContext routeContext) {
192        DataFormat dataFormat = DataFormatDefinition.getDataFormat(routeContext, getDataFormatType(), ref);
193        return new MarshalProcessor(dataFormat);
194    }
195}