001/**
002 * TextReplicator.java
003 *
004 * Copyright (c) 2004-2012, Nicole C. Tedesco.  All rights reserved.
005 *
006 * Licensed under the Apache License, Version 2.0 (the "License");
007 * you may not use this file except in compliance with the License.
008 * You may obtain a copy of the License at:
009 *
010 * http://www.apache.org/licenses/LICENSE-2.0
011 *
012 * Unless required by applicable law or agreed to in writing, software
013 * distributed under the License is distributed on an "AS IS" BASIS,
014 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
015 * See the License for the specific language governing permissions and
016 * limitations under the License.
017 */
018
019package net.sf.jaccumulator.texts;
020
021import net.sf.jaccumulator.Replicator;
022
023/**
024 * A {@link Replicator replicator} for {@link String text} primitives
025 *
026 * @param <TEXT>
027 *        the factory product
028 * @since JAccumulator 4.0
029 * @author Nicole Tedesco (<a
030 *         href="mailto:Nicole@NicoleTedesco.com">Nicole@NicoleTedesco.com</a>)
031 */
032public interface TextReplicator<TEXT extends TextReplicator<TEXT>>
033    extends
034        Replicator<TEXT>
035{
036    /**
037     * Using this text as a factory, produce new text of the same type but
038     * initialized with the value specified
039     *
040     * @param aValue
041     *        a new value
042     * @return a copy (clone) of this text initialized using the specified value
043     */
044    public TEXT copyUsingText( final CharSequence aValue );
045}