All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.apache.juneau.plaintext.PlainTextSerializer Maven / Gradle / Ivy

// ***************************************************************************************************************************
// * 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.juneau.plaintext;

import java.lang.annotation.*;
import java.lang.reflect.*;
import java.nio.charset.*;
import java.util.*;
import java.util.concurrent.*;

import org.apache.juneau.*;
import org.apache.juneau.internal.*;
import org.apache.juneau.serializer.*;
import org.apache.juneau.swap.*;
import org.apache.juneau.utils.*;

/**
 * Serializes POJOs to plain text using just the toString() method on the serialized object.
 *
 * 
Media types
* * Handles Accept types: text/plain *

* Produces Content-Type types: text/plain * *

Description
* * Essentially converts POJOs to plain text using the toString() method. * *

* Also serializes objects using a transform if the object class has an {@link ObjectSwap ObjectSwap<?,String>} * transform defined on it. * *

Notes:
    *
  • This class is thread safe and reusable. *
* *
See Also:
    *
*/ public class PlainTextSerializer extends WriterSerializer implements PlainTextMetaProvider { //------------------------------------------------------------------------------------------------------------------- // Static //------------------------------------------------------------------------------------------------------------------- /** Default serializer, all default settings.*/ public static final PlainTextSerializer DEFAULT = new PlainTextSerializer(create()); /** * Creates a new builder for this object. * * @return A new builder. */ public static Builder create() { return new Builder(); } //------------------------------------------------------------------------------------------------------------------- // Builder //------------------------------------------------------------------------------------------------------------------- /** * Builder class. */ @FluentSetters public static class Builder extends WriterSerializer.Builder { private static final Cache CACHE = Cache.of(HashKey.class, PlainTextSerializer.class).build(); /** * Constructor, default settings. */ protected Builder() { produces("text/plain"); } /** * Copy constructor. * * @param copyFrom The bean to copy from. */ protected Builder(PlainTextSerializer copyFrom) { super(copyFrom); } /** * Copy constructor. * * @param copyFrom The builder to copy from. */ protected Builder(Builder copyFrom) { super(copyFrom); } @Override /* Context.Builder */ public Builder copy() { return new Builder(this); } @Override /* Context.Builder */ public PlainTextSerializer build() { return cache(CACHE).build(PlainTextSerializer.class); } @Override /* Context.Builder */ public HashKey hashKey() { return super.hashKey(); } //----------------------------------------------------------------------------------------------------------------- // Properties //----------------------------------------------------------------------------------------------------------------- // @Override /* GENERATED - org.apache.juneau.Context.Builder */ public Builder annotations(Annotation...values) { super.annotations(values); return this; } @Override /* GENERATED - org.apache.juneau.Context.Builder */ public Builder apply(AnnotationWorkList work) { super.apply(work); return this; } @Override /* GENERATED - org.apache.juneau.Context.Builder */ public Builder applyAnnotations(java.lang.Class...fromClasses) { super.applyAnnotations(fromClasses); return this; } @Override /* GENERATED - org.apache.juneau.Context.Builder */ public Builder applyAnnotations(Method...fromMethods) { super.applyAnnotations(fromMethods); return this; } @Override /* GENERATED - org.apache.juneau.Context.Builder */ public Builder cache(Cache value) { super.cache(value); return this; } @Override /* GENERATED - org.apache.juneau.Context.Builder */ public Builder debug() { super.debug(); return this; } @Override /* GENERATED - org.apache.juneau.Context.Builder */ public Builder debug(boolean value) { super.debug(value); return this; } @Override /* GENERATED - org.apache.juneau.Context.Builder */ public Builder impl(Context value) { super.impl(value); return this; } @Override /* GENERATED - org.apache.juneau.Context.Builder */ public Builder type(Class value) { super.type(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanClassVisibility(Visibility value) { super.beanClassVisibility(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanConstructorVisibility(Visibility value) { super.beanConstructorVisibility(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanContext(BeanContext value) { super.beanContext(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanContext(BeanContext.Builder value) { super.beanContext(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanDictionary(java.lang.Class...values) { super.beanDictionary(values); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanFieldVisibility(Visibility value) { super.beanFieldVisibility(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanInterceptor(Class on, Class> value) { super.beanInterceptor(on, value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanMapPutReturnsOldValue() { super.beanMapPutReturnsOldValue(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanMethodVisibility(Visibility value) { super.beanMethodVisibility(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanProperties(Map values) { super.beanProperties(values); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanProperties(Class beanClass, String properties) { super.beanProperties(beanClass, properties); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanProperties(String beanClassName, String properties) { super.beanProperties(beanClassName, properties); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanPropertiesExcludes(Map values) { super.beanPropertiesExcludes(values); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanPropertiesExcludes(Class beanClass, String properties) { super.beanPropertiesExcludes(beanClass, properties); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanPropertiesExcludes(String beanClassName, String properties) { super.beanPropertiesExcludes(beanClassName, properties); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanPropertiesReadOnly(Map values) { super.beanPropertiesReadOnly(values); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanPropertiesReadOnly(Class beanClass, String properties) { super.beanPropertiesReadOnly(beanClass, properties); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanPropertiesReadOnly(String beanClassName, String properties) { super.beanPropertiesReadOnly(beanClassName, properties); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanPropertiesWriteOnly(Map values) { super.beanPropertiesWriteOnly(values); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanPropertiesWriteOnly(Class beanClass, String properties) { super.beanPropertiesWriteOnly(beanClass, properties); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beanPropertiesWriteOnly(String beanClassName, String properties) { super.beanPropertiesWriteOnly(beanClassName, properties); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beansRequireDefaultConstructor() { super.beansRequireDefaultConstructor(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beansRequireSerializable() { super.beansRequireSerializable(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder beansRequireSettersForGetters() { super.beansRequireSettersForGetters(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder dictionaryOn(Class on, java.lang.Class...values) { super.dictionaryOn(on, values); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder disableBeansRequireSomeProperties() { super.disableBeansRequireSomeProperties(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder disableIgnoreMissingSetters() { super.disableIgnoreMissingSetters(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder disableIgnoreTransientFields() { super.disableIgnoreTransientFields(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder disableIgnoreUnknownNullBeanProperties() { super.disableIgnoreUnknownNullBeanProperties(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder disableInterfaceProxies() { super.disableInterfaceProxies(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder example(Class pojoClass, T o) { super.example(pojoClass, o); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder example(Class pojoClass, String json) { super.example(pojoClass, json); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder findFluentSetters() { super.findFluentSetters(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder findFluentSetters(Class on) { super.findFluentSetters(on); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder ignoreInvocationExceptionsOnGetters() { super.ignoreInvocationExceptionsOnGetters(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder ignoreInvocationExceptionsOnSetters() { super.ignoreInvocationExceptionsOnSetters(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder ignoreUnknownBeanProperties() { super.ignoreUnknownBeanProperties(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder ignoreUnknownEnumValues() { super.ignoreUnknownEnumValues(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder implClass(Class interfaceClass, Class implClass) { super.implClass(interfaceClass, implClass); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder implClasses(Map,Class> values) { super.implClasses(values); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder interfaceClass(Class on, Class value) { super.interfaceClass(on, value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder interfaces(java.lang.Class...value) { super.interfaces(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder locale(Locale value) { super.locale(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder mediaType(MediaType value) { super.mediaType(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder notBeanClasses(java.lang.Class...values) { super.notBeanClasses(values); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder notBeanPackages(String...values) { super.notBeanPackages(values); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder propertyNamer(Class value) { super.propertyNamer(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder propertyNamer(Class on, Class value) { super.propertyNamer(on, value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder sortProperties() { super.sortProperties(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder sortProperties(java.lang.Class...on) { super.sortProperties(on); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder stopClass(Class on, Class value) { super.stopClass(on, value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder swap(Class normalClass, Class swappedClass, ThrowingFunction swapFunction) { super.swap(normalClass, swappedClass, swapFunction); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder swap(Class normalClass, Class swappedClass, ThrowingFunction swapFunction, ThrowingFunction unswapFunction) { super.swap(normalClass, swappedClass, swapFunction, unswapFunction); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder swaps(java.lang.Class...values) { super.swaps(values); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder timeZone(TimeZone value) { super.timeZone(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder typeName(Class on, String value) { super.typeName(on, value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder typePropertyName(String value) { super.typePropertyName(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder typePropertyName(Class on, String value) { super.typePropertyName(on, value); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder useEnumNames() { super.useEnumNames(); return this; } @Override /* GENERATED - org.apache.juneau.BeanContextable.Builder */ public Builder useJavaBeanIntrospector() { super.useJavaBeanIntrospector(); return this; } @Override /* GENERATED - org.apache.juneau.BeanTraverseContext.Builder */ public Builder detectRecursions() { super.detectRecursions(); return this; } @Override /* GENERATED - org.apache.juneau.BeanTraverseContext.Builder */ public Builder detectRecursions(boolean value) { super.detectRecursions(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanTraverseContext.Builder */ public Builder ignoreRecursions() { super.ignoreRecursions(); return this; } @Override /* GENERATED - org.apache.juneau.BeanTraverseContext.Builder */ public Builder ignoreRecursions(boolean value) { super.ignoreRecursions(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanTraverseContext.Builder */ public Builder initialDepth(int value) { super.initialDepth(value); return this; } @Override /* GENERATED - org.apache.juneau.BeanTraverseContext.Builder */ public Builder maxDepth(int value) { super.maxDepth(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder accept(String value) { super.accept(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder addBeanTypes() { super.addBeanTypes(); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder addBeanTypes(boolean value) { super.addBeanTypes(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder addRootType() { super.addRootType(); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder addRootType(boolean value) { super.addRootType(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder keepNullProperties() { super.keepNullProperties(); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder keepNullProperties(boolean value) { super.keepNullProperties(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder listener(Class value) { super.listener(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder produces(String value) { super.produces(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder sortCollections() { super.sortCollections(); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder sortCollections(boolean value) { super.sortCollections(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder sortMaps() { super.sortMaps(); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder sortMaps(boolean value) { super.sortMaps(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder trimEmptyCollections() { super.trimEmptyCollections(); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder trimEmptyCollections(boolean value) { super.trimEmptyCollections(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder trimEmptyMaps() { super.trimEmptyMaps(); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder trimEmptyMaps(boolean value) { super.trimEmptyMaps(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder trimStrings() { super.trimStrings(); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder trimStrings(boolean value) { super.trimStrings(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder uriContext(UriContext value) { super.uriContext(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder uriRelativity(UriRelativity value) { super.uriRelativity(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.Serializer.Builder */ public Builder uriResolution(UriResolution value) { super.uriResolution(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.WriterSerializer.Builder */ public Builder fileCharset(Charset value) { super.fileCharset(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.WriterSerializer.Builder */ public Builder maxIndent(int value) { super.maxIndent(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.WriterSerializer.Builder */ public Builder quoteChar(char value) { super.quoteChar(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.WriterSerializer.Builder */ public Builder quoteCharOverride(char value) { super.quoteCharOverride(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.WriterSerializer.Builder */ public Builder sq() { super.sq(); return this; } @Override /* GENERATED - org.apache.juneau.serializer.WriterSerializer.Builder */ public Builder streamCharset(Charset value) { super.streamCharset(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.WriterSerializer.Builder */ public Builder useWhitespace() { super.useWhitespace(); return this; } @Override /* GENERATED - org.apache.juneau.serializer.WriterSerializer.Builder */ public Builder useWhitespace(boolean value) { super.useWhitespace(value); return this; } @Override /* GENERATED - org.apache.juneau.serializer.WriterSerializer.Builder */ public Builder ws() { super.ws(); return this; } // } //------------------------------------------------------------------------------------------------------------------- // Instance //------------------------------------------------------------------------------------------------------------------- private final Map,PlainTextClassMeta> plainTextClassMetas = new ConcurrentHashMap<>(); private final Map plainTextBeanPropertyMetas = new ConcurrentHashMap<>(); /** * Constructor. * * @param builder * The builder for this object. */ public PlainTextSerializer(Builder builder) { super(builder); } @Override /* Context */ public Builder copy() { return new Builder(this); } @Override /* Context */ public PlainTextSerializerSession.Builder createSession() { return PlainTextSerializerSession.create(this); } @Override /* Context */ public PlainTextSerializerSession getSession() { return createSession().build(); } //----------------------------------------------------------------------------------------------------------------- // Extended metadata //----------------------------------------------------------------------------------------------------------------- @Override /* PlainTextMetaProvider */ public PlainTextClassMeta getPlainTextClassMeta(ClassMeta cm) { PlainTextClassMeta m = plainTextClassMetas.get(cm); if (m == null) { m = new PlainTextClassMeta(cm, this); plainTextClassMetas.put(cm, m); } return m; } @Override /* PlainTextMetaProvider */ public PlainTextBeanPropertyMeta getPlainTextBeanPropertyMeta(BeanPropertyMeta bpm) { if (bpm == null) return PlainTextBeanPropertyMeta.DEFAULT; PlainTextBeanPropertyMeta m = plainTextBeanPropertyMetas.get(bpm); if (m == null) { m = new PlainTextBeanPropertyMeta(bpm.getDelegateFor(), this); plainTextBeanPropertyMetas.put(bpm, m); } return m; } }