--- /dev/null
+/*******************************************************************************
+ * Copyright (c) 2000, 2012 IBM Corporation and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ * IBM Corporation - initial API and implementation
+ * Brock Janiczak <brockj@tpg.com.au> - [implementation] Streams not being closed in Javadoc views - https://bugs.eclipse.org/bugs/show_bug.cgi?id=214854
+ *******************************************************************************/
+package org.eclipse.jdt.internal.ui.text.java.hover;
+
+import org.eclipse.swt.widgets.Shell;
+
+import org.eclipse.jface.text.BadLocationException;
+import org.eclipse.jface.text.DefaultInformationControl;
+import org.eclipse.jface.text.IDocument;
+import org.eclipse.jface.text.IInformationControl;
+import org.eclipse.jface.text.IInformationControlCreator;
+import org.eclipse.jface.text.IRegion;
+import org.eclipse.jface.text.ITextHoverExtension;
+import org.eclipse.jface.text.ITextHoverExtension2;
+import org.eclipse.jface.text.ITextViewer;
+
+import org.eclipse.ui.IEditorInput;
+import org.eclipse.ui.IEditorPart;
+
+import org.eclipse.ui.editors.text.EditorsUI;
+
+import org.eclipse.jdt.core.ICodeAssist;
+import org.eclipse.jdt.core.IJavaElement;
+import org.eclipse.jdt.core.ITypeRoot;
+import org.eclipse.jdt.core.JavaModelException;
+
+import org.eclipse.jdt.ui.text.java.hover.IJavaEditorTextHover;
+
+import org.eclipse.jdt.internal.ui.JavaPlugin;
+import org.eclipse.jdt.internal.ui.javaeditor.EditorUtility;
+import org.eclipse.jdt.internal.ui.javaeditor.IClassFileEditorInput;
+import org.eclipse.jdt.internal.ui.javaeditor.WorkingCopyManager;
+import org.eclipse.jdt.internal.ui.text.JavaWordFinder;
+
+
+/**
+ * Abstract class for providing hover information for Java elements.
+ *
+ * @since 2.1
+ */
+public abstract class AbstractJavaEditorTextHover implements IJavaEditorTextHover, ITextHoverExtension, ITextHoverExtension2 {
+ private IEditorPart fEditor;
+
+ /*
+ * @see IJavaEditorTextHover#setEditor(IEditorPart)
+ */
+ public void setEditor(IEditorPart editor) {
+ fEditor= editor;
+ }
+
+ protected IEditorPart getEditor() {
+ return fEditor;
+ }
+
+ protected ICodeAssist getCodeAssist() {
+ if (fEditor != null) {
+ IEditorInput input= fEditor.getEditorInput();
+ if (input instanceof IClassFileEditorInput) {
+ IClassFileEditorInput cfeInput= (IClassFileEditorInput) input;
+ return cfeInput.getClassFile();
+ }
+
+ WorkingCopyManager manager= JavaPlugin.getDefault().getWorkingCopyManager();
+ return manager.getWorkingCopy(input, false);
+ }
+
+ return null;
+ }
+
+ /*
+ * @see org.eclipse.jface.text.ITextHoverExtension2#getHoverInfo2(org.eclipse.jface.text.ITextViewer, org.eclipse.jface.text.IRegion)
+ * @since 3.4
+ */
+ public Object getHoverInfo2(ITextViewer textViewer, IRegion hoverRegion) {
+ return getHoverInfo(textViewer, hoverRegion);
+ }
+
+ /*
+ * @see ITextHover#getHoverRegion(ITextViewer, int)
+ */
+ public IRegion getHoverRegion(ITextViewer textViewer, int offset) {
+ return JavaWordFinder.findWord(textViewer.getDocument(), offset);
+ }
+
+ /**
+ * Returns the Java elements at the given hover region.
+ *
+ * @param textViewer the text viewer
+ * @param hoverRegion the hover region
+ * @return the array with the Java elements or <code>null</code>
+ * @since 3.4
+ */
+ protected IJavaElement[] getJavaElementsAt(ITextViewer textViewer, IRegion hoverRegion) {
+ /*
+ * The region should be a word region an not of length 0.
+ * This check is needed because codeSelect(...) also finds
+ * the Java element if the offset is behind the word.
+ */
+ if (hoverRegion.getLength() == 0)
+ return null;
+
+ IDocument document= textViewer.getDocument();
+ if (document != null && isInheritDoc(document, hoverRegion))
+ return null;
+
+ ICodeAssist resolve= getCodeAssist();
+ if (resolve != null) {
+ try {
+ return resolve.codeSelect(hoverRegion.getOffset(), hoverRegion.getLength());
+ } catch (JavaModelException x) {
+ return null;
+ }
+ }
+ return null;
+ }
+
+ /**
+ * Returns whether the word is "inheritDoc".
+ *
+ * @param document the document
+ * @param wordRegion the word region
+ * @return <code>true</code> iff the word is "inheritDoc"
+ * @since 3.7
+ */
+ private static boolean isInheritDoc(IDocument document, IRegion wordRegion) {
+ try {
+ String word= document.get(wordRegion.getOffset(), wordRegion.getLength());
+ return "inheritDoc".equals(word); //$NON-NLS-1$
+ } catch (BadLocationException e) {
+ return false;
+ }
+ }
+
+ /*
+ * @see ITextHoverExtension#getHoverControlCreator()
+ * @since 3.0
+ */
+ public IInformationControlCreator getHoverControlCreator() {
+ return new IInformationControlCreator() {
+ public IInformationControl createInformationControl(Shell parent) {
+ return new DefaultInformationControl(parent, EditorsUI.getTooltipAffordanceString());
+ }
+ };
+ }
+
+ /**
+ * Delegate method for {@link JavaInformationProvider#getInformationPresenterControlCreator()}
+ *
+ * @return the information control creator or null if none is available
+ * @since 3.4
+ */
+ public IInformationControlCreator getInformationPresenterControlCreator() {
+ return new IInformationControlCreator() {
+ public IInformationControl createInformationControl(Shell shell) {
+ return new DefaultInformationControl(shell, true);
+ }
+ };
+ }
+
+ protected ITypeRoot getEditorInputJavaElement() {
+ IEditorPart editor= getEditor();
+ if (editor != null)
+ return EditorUtility.getEditorInputJavaElement(editor, false);
+ return null;
+ }
+}