Added PHPDoc Scanner and Code Completion Processor
[phpeclipse.git] / net.sourceforge.phpeclipse / src / net / sourceforge / phpeclipse / phpeditor / PHPSourceViewerConfiguration.java
1 /**********************************************************************
2 Copyright (c) 2000, 2002 IBM Corp. and others.
3 All rights reserved. This program and the accompanying materials
4 are made available under the terms of the Common Public License v1.0
5 which accompanies this distribution, and is available at
6 http://www.eclipse.org/legal/cpl-v10.html
7
8 Contributors:
9     IBM Corporation - Initial implementation
10     Klaus Hartlage - www.eclipseproject.de
11 **********************************************************************/
12 package net.sourceforge.phpeclipse.phpeditor;
13
14 import java.util.Vector;
15
16 import net.sourceforge.phpdt.internal.ui.text.java.JavaFormattingStrategy;
17 import net.sourceforge.phpdt.internal.ui.text.phpdoc.PHPDocCompletionProcessor;
18 import net.sourceforge.phpeclipse.PHPeclipsePlugin;
19 import net.sourceforge.phpeclipse.phpeditor.html.HTMLFormattingStrategy;
20 import net.sourceforge.phpeclipse.phpeditor.php.HTMLCompletionProcessor;
21 import net.sourceforge.phpeclipse.phpeditor.php.PHPAutoIndentStrategy;
22 import net.sourceforge.phpeclipse.phpeditor.php.PHPCompletionProcessor;
23 import net.sourceforge.phpeclipse.phpeditor.php.PHPDoubleClickSelector;
24 import net.sourceforge.phpeclipse.phpeditor.php.PHPPartitionScanner;
25 import net.sourceforge.phpeclipse.phpeditor.util.PHPColorProvider;
26
27 import org.eclipse.jface.preference.IPreferenceStore;
28 import org.eclipse.jface.text.DefaultAutoIndentStrategy;
29 import org.eclipse.jface.text.IAutoIndentStrategy;
30 import org.eclipse.jface.text.IDocument;
31 import org.eclipse.jface.text.ITextDoubleClickStrategy;
32 import org.eclipse.jface.text.ITextHover;
33 import org.eclipse.jface.text.TextAttribute;
34 import org.eclipse.jface.text.contentassist.ContentAssistant;
35 import org.eclipse.jface.text.contentassist.IContentAssistant;
36 import org.eclipse.jface.text.formatter.ContentFormatter;
37 import org.eclipse.jface.text.formatter.IContentFormatter;
38 import org.eclipse.jface.text.formatter.IFormattingStrategy;
39 import org.eclipse.jface.text.presentation.IPresentationReconciler;
40 import org.eclipse.jface.text.presentation.PresentationReconciler;
41 import org.eclipse.jface.text.rules.BufferedRuleBasedScanner;
42 import org.eclipse.jface.text.rules.DefaultDamagerRepairer;
43 import org.eclipse.jface.text.rules.DefaultPartitioner;
44 import org.eclipse.jface.text.rules.Token;
45 import org.eclipse.jface.text.source.IAnnotationHover;
46 import org.eclipse.jface.text.source.ISourceViewer;
47 import org.eclipse.jface.text.source.SourceViewerConfiguration;
48 import org.eclipse.swt.graphics.RGB;
49
50 /**
51  * Configuration for an <code>SourceViewer</code> which shows PHP code.
52  */
53 public class PHPSourceViewerConfiguration extends SourceViewerConfiguration {
54
55   public static final String HTML_DEFAULT = IDocument.DEFAULT_CONTENT_TYPE;
56   
57   private PHPEditor fEditor;
58   
59   private ContentFormatter fFormatter;
60   private HTMLFormattingStrategy fFormattingStrategy;
61   /**
62    * Single token scanner.
63    */
64   static class SingleTokenScanner extends BufferedRuleBasedScanner {
65     public SingleTokenScanner(TextAttribute attribute) {
66       setDefaultReturnToken(new Token(attribute));
67     }
68   };
69
70   /**
71    * Default constructor.
72    */
73   public PHPSourceViewerConfiguration(PHPEditor editor) {
74     fEditor = editor;
75   }
76
77   /*
78    * @see SourceViewerConfiguration#getContentFormatter(ISourceViewer)
79    */
80   public IContentFormatter getContentFormatter(ISourceViewer sourceViewer) {
81 //    if (fFormatter == null) {
82 //      fFormatter = new ContentFormatter();
83 //      fFormattingStrategy = new HTMLFormattingStrategy(this, sourceViewer);
84 //      fFormatter.setFormattingStrategy(fFormattingStrategy, HTML_DEFAULT);
85 //      fFormatter.enablePartitionAwareFormatting(false);
86 //      fFormatter.setPartitionManagingPositionCategories(getConfiguredContentTypes(null));
87 //    }
88 //    return fFormatter;
89     
90     if (fFormatter == null) {
91     //ContentFormatter 
92     fFormatter= new ContentFormatter();
93     IFormattingStrategy strategy= new JavaFormattingStrategy(sourceViewer);
94                 
95     fFormatter.setFormattingStrategy(strategy, IDocument.DEFAULT_CONTENT_TYPE);
96     fFormatter.enablePartitionAwareFormatting(false);           
97     fFormatter.setPartitionManagingPositionCategories(getPartitionManagingPositionCategories());
98     }
99     return fFormatter;
100   }
101   
102   /**
103    * Returns the names of the document position categories used by the document
104    * partitioners created by this object to manage their partition information.
105    * If the partitioners don't use document position categories, the returned
106    * result is <code>null</code>.
107    *
108    * @return the partition managing position categories or <code>null</code> 
109    *                    if there is none
110    */
111   public String[] getPartitionManagingPositionCategories() {
112     return new String[] { DefaultPartitioner.CONTENT_TYPES_CATEGORY };
113   }
114 //  /**
115 //   * Returns the names of the document position categories used by the document
116 //   * partitioners created by this object to manage their partition information.
117 //   * If the partitioners don't use document position categories, the returned
118 //   * result is <code>null</code>.
119 //   *
120 //   * @return the partition managing position categories or <code>null</code> 
121 //   *                  if there is none
122 //   */
123 //  private String[] getPartitionManagingPositionCategories() {
124 //    return new String[] { DefaultPartitioner.CONTENT_TYPES_CATEGORY };
125 //  } 
126   
127   public PHPEditor getEditor() {
128     return fEditor;
129   }
130   /* (non-Javadoc)
131    * Method declared on SourceViewerConfiguration
132    */
133   public IAnnotationHover getAnnotationHover(ISourceViewer sourceViewer) {
134     return new PHPAnnotationHover();
135   }
136
137   /* (non-Javadoc)
138    * Method declared on SourceViewerConfiguration
139    */
140   public IAutoIndentStrategy getAutoIndentStrategy(ISourceViewer sourceViewer, String contentType) {
141     return (IDocument.DEFAULT_CONTENT_TYPE.equals(contentType) ? new PHPAutoIndentStrategy() : new DefaultAutoIndentStrategy());
142   }
143
144   /* (non-Javadoc)
145    * Method declared on SourceViewerConfiguration
146    */
147   public String[] getConfiguredContentTypes(ISourceViewer sourceViewer) {
148     return new String[] { IDocument.DEFAULT_CONTENT_TYPE, PHPPartitionScanner.PHP,
149       //        PHPPartitionScanner.JAVA_DOC,
150       PHPPartitionScanner.HTML_MULTILINE_COMMENT };
151   }
152
153   /* (non-Javadoc)
154    * Method declared on SourceViewerConfiguration
155    */
156   public IContentAssistant getContentAssistant(ISourceViewer sourceViewer) {
157
158     ContentAssistant assistant = new ContentAssistant();
159     assistant.setContentAssistProcessor(new HTMLCompletionProcessor(), IDocument.DEFAULT_CONTENT_TYPE);
160     assistant.setContentAssistProcessor(new PHPCompletionProcessor(), PHPPartitionScanner.PHP);
161     assistant.setContentAssistProcessor(new PHPDocCompletionProcessor(), PHPPartitionScanner.PHP_MULTILINE_COMMENT);
162     
163     assistant.enableAutoActivation(true);
164     assistant.setAutoActivationDelay(500);
165     assistant.setProposalPopupOrientation(ContentAssistant.PROPOSAL_OVERLAY);
166     assistant.setContextInformationPopupOrientation(ContentAssistant.CONTEXT_INFO_ABOVE);
167     assistant.setContextInformationPopupBackground(PHPEditorEnvironment.getPHPColorProvider().getColor(new RGB(150, 150, 0)));
168
169     return assistant;
170   }
171
172   /* (non-Javadoc)
173    * Method declared on SourceViewerConfiguration
174    */
175 //  public String getDefaultPrefix(ISourceViewer sourceViewer, String contentType) {
176 //    return (PHPPartitionScanner.PHP.equals(contentType) ? "//" : null); //$NON-NLS-1$
177 //    // return (IDocument.DEFAULT_CONTENT_TYPE.equals(contentType) ? "//" : null); //$NON-NLS-1$
178 //  }
179
180   /*
181    * @see SourceViewerConfiguration#getDefaultPrefix(ISourceViewer, String)
182    * @since 2.0
183    */
184   public String[] getDefaultPrefixes(ISourceViewer sourceViewer, String contentType) {
185     return new String[] { "//", "" }; //$NON-NLS-1$ //$NON-NLS-2$
186   }
187   
188   /* (non-Javadoc)
189    * Method declared on SourceViewerConfiguration
190    */
191   public ITextDoubleClickStrategy getDoubleClickStrategy(ISourceViewer sourceViewer, String contentType) {
192     return new PHPDoubleClickSelector();
193   }
194
195   /* (non-Javadoc)
196    * Method declared on SourceViewerConfiguration
197    */
198 //  public String[] getIndentPrefixes(ISourceViewer sourceViewer, String contentType) {
199 //    return new String[] { "\t", "    " }; //$NON-NLS-1$ //$NON-NLS-2$
200 //  }
201
202   /*
203    * @see SourceViewerConfiguration#getIndentPrefixes(ISourceViewer, String)
204    */
205   public String[] getIndentPrefixes(ISourceViewer sourceViewer, String contentType) {
206
207     Vector vector= new Vector();
208
209     // prefix[0] is either '\t' or ' ' x tabWidth, depending on useSpaces
210         
211     final IPreferenceStore store = PHPeclipsePlugin.getDefault().getPreferenceStore();
212
213     int tabWidth= store.getInt(PHPeclipsePlugin.FORMATTER_TAB_SIZE);
214     boolean useSpaces= store.getBoolean(PHPeclipsePlugin.SPACES_FOR_TABS);
215     
216     for (int i= 0; i <= tabWidth; i++) {
217         StringBuffer prefix= new StringBuffer();
218
219       if (useSpaces) {
220           for (int j= 0; j + i < tabWidth; j++)
221             prefix.append(' ');
222           
223         if (i != 0)
224             prefix.append('\t');        
225       } else {    
226           for (int j= 0; j < i; j++)
227             prefix.append(' ');
228           
229         if (i != tabWidth)
230             prefix.append('\t');
231       }
232       
233       vector.add(prefix.toString());
234     }
235
236     vector.add(""); //$NON-NLS-1$
237     
238     return (String[]) vector.toArray(new String[vector.size()]);
239   }
240   /* (non-Javadoc)
241    * Method declared on SourceViewerConfiguration
242    */
243   public IPresentationReconciler getPresentationReconciler(ISourceViewer sourceViewer) {
244
245     PHPColorProvider provider = PHPEditorEnvironment.getPHPColorProvider();
246     PresentationReconciler reconciler = new PresentationReconciler();
247     
248     DefaultDamagerRepairer dr= new DefaultDamagerRepairer(PHPEditorEnvironment.getHTMLCodeScanner());
249     reconciler.setDamager(dr, IDocument.DEFAULT_CONTENT_TYPE);
250     reconciler.setRepairer(dr, IDocument.DEFAULT_CONTENT_TYPE);
251     
252 //    dr = new DefaultDamagerRepairer(new SingleTokenScanner(new TextAttribute(provider.getColor(provider.HTML_DEFAULT))));
253 //    reconciler.setDamager(dr, IDocument.DEFAULT_CONTENT_TYPE);
254 //    reconciler.setRepairer(dr, IDocument.DEFAULT_CONTENT_TYPE);
255
256     dr = new DefaultDamagerRepairer(PHPEditorEnvironment.getPHPCodeScanner());
257     reconciler.setDamager(dr, PHPPartitionScanner.PHP);
258     reconciler.setRepairer(dr, PHPPartitionScanner.PHP);
259
260     dr = new DefaultDamagerRepairer(PHPEditorEnvironment.getPHPDocCodeScanner());
261     reconciler.setDamager(dr, PHPPartitionScanner.PHP_MULTILINE_COMMENT);
262     reconciler.setRepairer(dr, PHPPartitionScanner.PHP_MULTILINE_COMMENT);
263     
264 //    dr = new DefaultDamagerRepairer(PHPEditorEnvironment.getHTMLCodeScanner());
265 //    reconciler.setDamager(dr, PHPPartitionScanner.HTML);
266 //    reconciler.setRepairer(dr, PHPPartitionScanner.HTML);
267
268     dr = new DefaultDamagerRepairer(new SingleTokenScanner(new TextAttribute(provider.getColor(PHPColorProvider.MULTI_LINE_COMMENT))));
269     reconciler.setDamager(dr, PHPPartitionScanner.HTML_MULTILINE_COMMENT);
270     reconciler.setRepairer(dr, PHPPartitionScanner.HTML_MULTILINE_COMMENT);
271
272     return reconciler;
273   }
274
275   /* (non-Javadoc)
276    * Method declared on SourceViewerConfiguration
277    */
278   public int getTabWidth(ISourceViewer sourceViewer) {
279     return 4;
280   }
281
282   /* (non-Javadoc)
283    * Method declared on SourceViewerConfiguration
284    */
285   public ITextHover getTextHover(ISourceViewer sourceViewer, String contentType) {
286     return new PHPTextHover();
287   }
288 }