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.commons.text.diff; 018 019/** 020 * Command representing the insertion of one object of the second sequence. 021 * <p> 022 * When one object of the second sequence has no corresponding object in the 023 * first sequence at the right place, the {@link EditScript edit script} 024 * transforming the first sequence into the second sequence uses an instance of 025 * this class to represent the insertion of this object. The objects embedded in 026 * these type of commands always come from the second sequence. 027 * </p> 028 * 029 * @see StringsComparator 030 * @see EditScript 031 * 032 * @param <T> object type 033 * @since 1.0 034 */ 035public class InsertCommand<T> extends EditCommand<T> { 036 037 /** 038 * Constructs a new instance of InsertCommand. 039 * 040 * @param object the object of the second sequence that should be inserted 041 */ 042 public InsertCommand(final T object) { 043 super(object); 044 } 045 046 /** 047 * Accepts a visitor. When an {@code InsertCommand} accepts a visitor, 048 * it calls its {@link CommandVisitor#visitInsertCommand visitInsertCommand} 049 * method. 050 * 051 * @param visitor the visitor to be accepted 052 */ 053 @Override 054 public void accept(final CommandVisitor<T> visitor) { 055 visitor.visitInsertCommand(getObject()); 056 } 057 058}