001// *************************************************************************************************************************** 002// * Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file * 003// * distributed with this work for additional information regarding copyright ownership. The ASF licenses this file * 004// * to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance * 005// * with the License. You may obtain a copy of the License at * 006// * * 007// * http://www.apache.org/licenses/LICENSE-2.0 * 008// * * 009// * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an * 010// * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the * 011// * specific language governing permissions and limitations under the License. * 012// *************************************************************************************************************************** 013package org.apache.juneau.marshall; 014 015import org.apache.juneau.jena.*; 016 017/** 018 * A pairing of a {@link TurtleSerializer} and {@link TurtleParser} into a single class with convenience read/write methods. 019 * 020 * <p> 021 * The general idea is to combine a single serializer and parser inside a simplified API for reading and writing POJOs. 022 * 023 * <h5 class='figure'>Examples:</h5> 024 * <p class='bcode w800'> 025 * <jc>// Using instance.</jc> 026 * Turtle turtle = <jk>new</jk> Turtle(); 027 * MyPojo myPojo = turtle.read(string, MyPojo.<jk>class</jk>); 028 * String string = turtle.write(myPojo); 029 * </p> 030 * <p class='bcode w800'> 031 * <jc>// Using DEFAULT instance.</jc> 032 * MyPojo myPojo = Turtle.<jsf>DEFAULT</jsf>.read(string, MyPojo.<jk>class</jk>); 033 * String string = Turtle.<jsf>DEFAULT</jsf>.write(myPojo); 034 * </p> 035 */ 036public class Turtle extends CharMarshall { 037 038 /** 039 * Default reusable instance. 040 */ 041 public static final Turtle DEFAULT = new Turtle(); 042 043 /** 044 * Constructor. 045 * 046 * @param s 047 * The serializer to use for serializing output. 048 * <br>Must not be <jk>null</jk>. 049 * @param p 050 * The parser to use for parsing input. 051 * <br>Must not be <jk>null</jk>. 052 */ 053 public Turtle(TurtleSerializer s, TurtleParser p) { 054 super(s, p); 055 } 056 057 /** 058 * Constructor. 059 * 060 * <p> 061 * Uses {@link TurtleSerializer#DEFAULT} and {@link TurtleParser#DEFAULT}. 062 */ 063 public Turtle() { 064 this(TurtleSerializer.DEFAULT, TurtleParser.DEFAULT); 065 } 066}