org.eclipse.jface.text.templates.TemplateBuffer Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of aspectjtools Show documentation

AspectJ tools most notably contains the AspectJ compiler (AJC). AJC applies aspects to Java classes during compilation, fully replacing Javac for plain Java classes and also compiling native AspectJ or annotation-based @AspectJ syntax. Furthermore, AJC can weave aspects into existing class files in a post-compile binary weaving step. This library is a superset of AspectJ weaver and hence also of AspectJ runtime.

There is a newer version: 1.9.22.1

Show newest version

/*******************************************************************************
 * Copyright (c) 2000, 2008 IBM Corporation and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.jface.text.templates;

import org.eclipse.core.runtime.Assert;

/**
 * A template buffer is a container for a string and variables.
 * 
 * Clients may instantiate this class.
 * 
 *
 * @since 3.0
 */
public final class TemplateBuffer {

	/** The string of the template buffer */
	private String fString;
	/** The variable positions of the template buffer */
	private TemplateVariable[] fVariables;

	/**
	 * Creates a template buffer.
	 *
	 * @param string the string
	 * @param variables the variable positions
	 */
	public TemplateBuffer(String string, TemplateVariable[] variables) {
		setContent(string, variables);
	}

	/**
	 * Sets the content of the template buffer.
	 *
	 * @param string the string
	 * @param variables the variable positions
	 */
	public final void setContent(String string, TemplateVariable[] variables) {
		Assert.isNotNull(string);
		Assert.isNotNull(variables);

		// XXX: assert non-overlapping variable properties

		fString= string;
		fVariables= copy(variables);
	}

	/**
	 * Returns a copy of the given array.
	 *
	 * @param array the array to be copied
	 * @return a copy of the given array or null when array is null
	 * @since 3.1
	 */
	private static TemplateVariable[] copy(TemplateVariable[] array) {
		if (array != null) {
			TemplateVariable[] copy= new TemplateVariable[array.length];
			System.arraycopy(array, 0, copy, 0, array.length);
			return copy;
		}
		return null;
	}

	/**
	 * Returns the string of the template buffer.
	 *
	 * @return the string representation of the template buffer
	 */
	public final String getString() {
		return fString;
	}

	/**
	 * Returns the variable positions of the template buffer. The returned array is
	 * owned by this variable and must not be modified.
	 *
	 * @return the variable positions of the template buffer
	 */
	public final TemplateVariable[] getVariables() {
		return fVariables;
	}

}