| /******************************************************************************* |
| * Copyright (c) 2000, 2016 IBM Corporation and others. |
| * All rights reserved. This program and the accompanying materials |
| * are made available under the terms of the Eclipse Public License v2.0 |
| * which accompanies this distribution, and is available at |
| * https://www.eclipse.org/legal/epl-2.0/ |
| * |
| * Contributors: |
| * IBM Corporation - initial API and implementation |
| *******************************************************************************/ |
| package org.eclipse.wst.jsdt.ui.text; |
| |
| import org.eclipse.core.runtime.Preferences; |
| import org.eclipse.jface.preference.IPreferenceStore; |
| import org.eclipse.jface.text.IDocument; |
| import org.eclipse.jface.text.IDocumentExtension3; |
| import org.eclipse.jface.text.IDocumentPartitioner; |
| import org.eclipse.jface.text.rules.FastPartitioner; |
| import org.eclipse.jface.text.rules.IPartitionTokenScanner; |
| import org.eclipse.jface.util.IPropertyChangeListener; |
| import org.eclipse.jface.util.PropertyChangeEvent; |
| import org.eclipse.wst.jsdt.internal.ui.text.FastJavaPartitionScanner; |
| import org.eclipse.wst.jsdt.internal.ui.text.JavaColorManager; |
| import org.eclipse.wst.jsdt.internal.ui.text.JavaCommentScanner; |
| import org.eclipse.wst.jsdt.internal.ui.text.SingleTokenJavaScanner; |
| import org.eclipse.wst.jsdt.internal.ui.text.java.JavaCodeScanner; |
| import org.eclipse.wst.jsdt.internal.ui.text.javadoc.JavaDocScanner; |
| |
| |
| /** |
| * Tools required to configure a JavaScript text viewer. |
| * The color manager and all scanner exist only one time, i.e. |
| * the same instances are returned to all clients. Thus, clients |
| * share those tools. |
| * <p> |
| * This class may be instantiated; it is not intended to be subclassed. |
| * </p> |
| * |
| * Provisional API: This class/interface is part of an interim API that is still under development and expected to |
| * change significantly before reaching stability. It is being made available at this early stage to solicit feedback |
| * from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken |
| * (repeatedly) as the API evolves. |
| */ |
| public class JavaScriptTextTools { |
| |
| /** |
| * Array with legal content types. |
| * |
| */ |
| private final static String[] LEGAL_CONTENT_TYPES= new String[] { |
| IJavaScriptPartitions.JAVA_DOC, |
| IJavaScriptPartitions.JAVA_MULTI_LINE_COMMENT, |
| IJavaScriptPartitions.JAVA_SINGLE_LINE_COMMENT, |
| IJavaScriptPartitions.JAVA_STRING, |
| IJavaScriptPartitions.JAVA_CHARACTER, |
| IJavaScriptPartitions.JAVASCRIPT_TEMPLATE_LITERAL |
| }; |
| |
| /** |
| * This tools' preference listener. |
| */ |
| private class PreferenceListener implements IPropertyChangeListener, Preferences.IPropertyChangeListener { |
| public void propertyChange(PropertyChangeEvent event) { |
| adaptToPreferenceChange(event); |
| } |
| public void propertyChange(Preferences.PropertyChangeEvent event) { |
| adaptToPreferenceChange(new PropertyChangeEvent(event.getSource(), event.getProperty(), event.getOldValue(), event.getNewValue())); |
| } |
| } |
| |
| /** The color manager. */ |
| private JavaColorManager fColorManager; |
| /** The JavaScript source code scanner. */ |
| private JavaCodeScanner fCodeScanner; |
| /** The JavaScript multi-line comment scanner. */ |
| private JavaCommentScanner fMultilineCommentScanner; |
| /** The JavaScript template literal scanner. */ |
| private SingleTokenJavaScanner fTemplateLiteralScanner; |
| /** The JavaScript single-line comment scanner. */ |
| private JavaCommentScanner fSinglelineCommentScanner; |
| /** The JavaScript string scanner. */ |
| private SingleTokenJavaScanner fStringScanner; |
| /** The JavaDoc scanner. */ |
| private JavaDocScanner fJavaDocScanner; |
| /** The preference store. */ |
| private IPreferenceStore fPreferenceStore; |
| /** |
| * The core preference store. |
| * |
| */ |
| private Preferences fCorePreferenceStore; |
| /** The preference change listener */ |
| private PreferenceListener fPreferenceListener= new PreferenceListener(); |
| |
| |
| /** |
| * Creates a new JavaScript text tools collection. |
| * |
| * @param store the preference store to initialize the text tools. The text tool |
| * instance installs a listener on the passed preference store to adapt itself to |
| * changes in the preference store. In general <code>PreferenceConstants. |
| * getPreferenceStore()</code> should be used to initialize the text tools. |
| * @see org.eclipse.wst.jsdt.ui.PreferenceConstants#getPreferenceStore() |
| * |
| */ |
| public JavaScriptTextTools(IPreferenceStore store) { |
| this(store, null, true); |
| } |
| |
| /** |
| * Creates a new JavaScript text tools collection. |
| * |
| * @param store the preference store to initialize the text tools. The text tool |
| * instance installs a listener on the passed preference store to adapt itself to |
| * changes in the preference store. In general <code>PreferenceConstants. |
| * getPreferenceStore()</code> should be used to initialize the text tools. |
| * @param autoDisposeOnDisplayDispose if <code>true</code> the color manager |
| * automatically disposes all managed colors when the current display gets disposed |
| * and all calls to {@link org.eclipse.jface.text.source.ISharedTextColors#dispose()} are ignored. |
| * @see org.eclipse.wst.jsdt.ui.PreferenceConstants#getPreferenceStore() |
| * |
| */ |
| public JavaScriptTextTools(IPreferenceStore store, boolean autoDisposeOnDisplayDispose) { |
| this(store, null, autoDisposeOnDisplayDispose); |
| } |
| |
| /** |
| * Creates a new JavaScript text tools collection. |
| * @param store the preference store to initialize the text tools. The text tool |
| * instance installs a listener on the passed preference store to adapt itself to |
| * changes in the preference store. In general <code>PreferenceConstants. |
| * getPreferenceStore()</code> should be used to initialize the text tools. |
| * @param coreStore optional preference store to initialize the text tools. The text tool |
| * instance installs a listener on the passed preference store to adapt itself to |
| * changes in the preference store. |
| * @see org.eclipse.wst.jsdt.ui.PreferenceConstants#getPreferenceStore() |
| * |
| */ |
| public JavaScriptTextTools(IPreferenceStore store, Preferences coreStore) { |
| this(store, coreStore, true); |
| } |
| |
| /** |
| * Creates a new JavaScript text tools collection. |
| * |
| * @param store the preference store to initialize the text tools. The text tool |
| * instance installs a listener on the passed preference store to adapt itself to |
| * changes in the preference store. In general <code>PreferenceConstants. |
| * getPreferenceStore()</code> should be used to initialize the text tools. |
| * @param coreStore optional preference store to initialize the text tools. The text tool |
| * instance installs a listener on the passed preference store to adapt itself to |
| * changes in the preference store. |
| * @param autoDisposeOnDisplayDispose if <code>true</code> the color manager |
| * automatically disposes all managed colors when the current display gets disposed |
| * and all calls to {@link org.eclipse.jface.text.source.ISharedTextColors#dispose()} are ignored. |
| * @see org.eclipse.wst.jsdt.ui.PreferenceConstants#getPreferenceStore() |
| * |
| */ |
| public JavaScriptTextTools(IPreferenceStore store, Preferences coreStore, boolean autoDisposeOnDisplayDispose) { |
| fPreferenceStore= store; |
| fPreferenceStore.addPropertyChangeListener(fPreferenceListener); |
| |
| fCorePreferenceStore= coreStore; |
| if (fCorePreferenceStore != null) |
| fCorePreferenceStore.addPropertyChangeListener(fPreferenceListener); |
| |
| fColorManager= new JavaColorManager(autoDisposeOnDisplayDispose); |
| fCodeScanner= new JavaCodeScanner(fColorManager, store); |
| fMultilineCommentScanner= new JavaCommentScanner(fColorManager, store, coreStore, IJavaScriptColorConstants.JAVA_MULTI_LINE_COMMENT); |
| fTemplateLiteralScanner = new SingleTokenJavaScanner(fColorManager, store, IJavaScriptColorConstants.JAVASCRIPT_TEMPLATE_LITERAL); |
| fSinglelineCommentScanner= new JavaCommentScanner(fColorManager, store, coreStore, IJavaScriptColorConstants.JAVA_SINGLE_LINE_COMMENT); |
| fStringScanner= new SingleTokenJavaScanner(fColorManager, store, IJavaScriptColorConstants.JAVA_STRING); |
| fJavaDocScanner= new JavaDocScanner(fColorManager, store, coreStore); |
| } |
| |
| /** |
| * Disposes all the individual tools of this tools collection. |
| */ |
| public void dispose() { |
| |
| fCodeScanner= null; |
| fMultilineCommentScanner= null; |
| fSinglelineCommentScanner= null; |
| fTemplateLiteralScanner = null; |
| fStringScanner= null; |
| fJavaDocScanner= null; |
| |
| if (fColorManager != null) { |
| fColorManager.dispose(); |
| fColorManager= null; |
| } |
| |
| if (fPreferenceStore != null) { |
| fPreferenceStore.removePropertyChangeListener(fPreferenceListener); |
| fPreferenceStore= null; |
| |
| if (fCorePreferenceStore != null) { |
| fCorePreferenceStore.removePropertyChangeListener(fPreferenceListener); |
| fCorePreferenceStore= null; |
| } |
| |
| fPreferenceListener= null; |
| } |
| } |
| |
| /** |
| * Returns the color manager which is used to manage |
| * any Java-specific colors needed for such things like syntax highlighting. |
| * <p> |
| * Clients which are only interested in the color manager of the JavaScript UI |
| * plug-in should use {@link org.eclipse.wst.jsdt.ui.JavaScriptUI#getColorManager()}. |
| * </p> |
| * |
| * @return the color manager to be used for JavaScript text viewers |
| * @see org.eclipse.wst.jsdt.ui.JavaScriptUI#getColorManager() |
| */ |
| public IColorManager getColorManager() { |
| return fColorManager; |
| } |
| |
| /** |
| * Returns a scanner which is configured to scan |
| * Java-specific partitions, which are multi-line comments, |
| * Javadoc comments, and regular JavaScript source code. |
| * |
| * @return a JavaScript partition scanner |
| */ |
| public IPartitionTokenScanner getPartitionScanner() { |
| return new FastJavaPartitionScanner(); |
| } |
| |
| /** |
| * Factory method for creating a Java-specific document partitioner |
| * using this object's partitions scanner. This method is a |
| * convenience method. |
| * |
| * @return a newly created JavaScript document partitioner |
| */ |
| public IDocumentPartitioner createDocumentPartitioner() { |
| return new FastPartitioner(getPartitionScanner(), LEGAL_CONTENT_TYPES); |
| } |
| |
| /** |
| * Adapts the behavior of the contained components to the change |
| * encoded in the given event. |
| * |
| * @param event the event to which to adapt |
| * |
| * @deprecated As of 3.0, no replacement |
| */ |
| protected void adaptToPreferenceChange(PropertyChangeEvent event) { |
| if (fCodeScanner.affectsBehavior(event)) |
| fCodeScanner.adaptToPreferenceChange(event); |
| if (fMultilineCommentScanner.affectsBehavior(event)) |
| fMultilineCommentScanner.adaptToPreferenceChange(event); |
| if (fTemplateLiteralScanner.affectsBehavior(event)) |
| fTemplateLiteralScanner.adaptToPreferenceChange(event); |
| if (fSinglelineCommentScanner.affectsBehavior(event)) |
| fSinglelineCommentScanner.adaptToPreferenceChange(event); |
| if (fStringScanner.affectsBehavior(event)) |
| fStringScanner.adaptToPreferenceChange(event); |
| if (fJavaDocScanner.affectsBehavior(event)) |
| fJavaDocScanner.adaptToPreferenceChange(event); |
| } |
| |
| /** |
| * Sets up the JavaScript document partitioner for the given document for the default partitioning. |
| * |
| * @param document the document to be set up |
| * |
| */ |
| public void setupJavaDocumentPartitioner(IDocument document) { |
| setupJavaDocumentPartitioner(document, IDocumentExtension3.DEFAULT_PARTITIONING); |
| } |
| |
| /** |
| * Sets up the JavaScript document partitioner for the given document for the given partitioning. |
| * |
| * @param document the document to be set up |
| * @param partitioning the document partitioning |
| * |
| */ |
| public void setupJavaDocumentPartitioner(IDocument document, String partitioning) { |
| IDocumentPartitioner partitioner= createDocumentPartitioner(); |
| if (document instanceof IDocumentExtension3) { |
| IDocumentExtension3 extension3= (IDocumentExtension3) document; |
| extension3.setDocumentPartitioner(partitioning, partitioner); |
| } else { |
| document.setDocumentPartitioner(partitioner); |
| } |
| partitioner.connect(document); |
| } |
| |
| /** |
| * Returns this text tool's preference store. |
| * |
| * @return the preference store |
| * |
| */ |
| protected IPreferenceStore getPreferenceStore() { |
| return fPreferenceStore; |
| } |
| |
| /** |
| * Returns this text tool's core preference store. |
| * |
| * @return the core preference store |
| * |
| */ |
| protected Preferences getCorePreferenceStore() { |
| return fCorePreferenceStore; |
| } |
| } |