import org.eclipse.core.runtime.IProgressMonitor;

	/**

	 * <p>Returns the Javadoc as an html source if this element has an attached javadoc,

	 * null otherwise.</p> 

	 * <p>This should be used only for binary elements. Source elements will always return null.

	 * The encoding used to read the javadoc is the one defined by the content type of the

	 * file. If none is defined, then the specified encoding will be used as the default encoding.</p>

	 * 

	 * <p>The html is extracted from the attached javadoc and provided as is. No

	 * transformation or validation is done.</p>

	 *

	 * <p>If the default encoding is set to null, the platform encoding is used.</p>

	 * 

	 * <p>NOTE: This API is subject to change before the 3.2 release.</p>

	 * 

	 * @param monitor the given progress monitor

	 * @param encoding the given default encoding

	 * @exception JavaModelException if:<u>

	 *  <li>this element does not exist</li>

	 *  <li>retrieving the attached javadoc fails (timed-out, invalid URL, ...)

	 *  <li>the format of the javadoc doesn't match expected standards (different anchors,...)</li>

	 *  </u>

	 * @return the extracted javadoc from the attached javadoc, null if none

	 * @see IClasspathAttribute#JAVADOC_LOCATION_ATTRIBUTE_NAME

	 * @since 3.2

	 */

	String getAttachedJavadoc(IProgressMonitor monitor, String encoding) throws JavaModelException;	

import java.net.URL;

import org.eclipse.core.runtime.IProgressMonitor;

import org.eclipse.jdt.core.IJavaModelStatusConstants;

import org.eclipse.jdt.core.IPackageFragment;

import org.eclipse.jdt.core.IType;

public String getAttachedJavadoc(IProgressMonitor monitor, String encoding) throws JavaModelException {

	URL baseLocation= getJavadocBaseLocation();

	if (baseLocation == null) {

		return null;

	}

	StringBuffer pathBuffer = new StringBuffer(baseLocation.toExternalForm());

	if (!(pathBuffer.charAt(pathBuffer.length() - 1) == '/')) {

		pathBuffer.append('/');

	}

	IType declaringType = this.getDeclaringType();

	IPackageFragment pack= declaringType.getPackageFragment();

	pathBuffer.append(pack.getElementName().replace('.', '/')).append('/').append(declaringType.getTypeQualifiedName('.')).append(JavadocConstants.HTML_EXTENSION);

	String contents = getURLContents(String.valueOf(pathBuffer), encoding);

	if (contents == null) throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.CANNOT_RETRIEVE_ATTACHED_JAVADOC, this));

	int indexAnchor = contents.indexOf(

			JavadocConstants.ANCHOR_PREFIX_START + this.getElementName() + JavadocConstants.ANCHOR_PREFIX_END);

	if (indexAnchor == -1) throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.UNRECOGNIZED_JAVADOC_FORMAT, this));

	int indexOfEndLink = contents.indexOf(JavadocConstants.ANCHOR_SUFFIX, indexAnchor);

	if (indexOfEndLink == -1) throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.UNRECOGNIZED_JAVADOC_FORMAT, this));

	int indexOfNextField = contents.indexOf(JavadocConstants.ANCHOR_PREFIX_START, indexOfEndLink);

	int indexOfBottom = contents.indexOf(JavadocConstants.CONSTRUCTOR_DETAIL, indexOfEndLink);

	indexOfNextField= Math.min(indexOfNextField, indexOfBottom);

	if (indexOfNextField == -1) throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.UNRECOGNIZED_JAVADOC_FORMAT, this));

	return contents.substring(indexOfEndLink + JavadocConstants.ANCHOR_SUFFIX_LENGTH, indexOfNextField);

}

public String getAttachedJavadoc(IProgressMonitor monitor, String encoding) throws JavaModelException {

	return this.getType().getAttachedJavadoc(monitor, encoding);

}

import java.util.HashSet;

import org.eclipse.jdt.core.IJavaModelStatusConstants;

import org.eclipse.jdt.core.IParent;

import org.eclipse.jdt.core.ISourceManipulation;

import org.eclipse.jdt.core.WorkingCopyOwner;

/*

 * @see IJavaElement#getAttachedJavadoc(IProgressMonitor)

 */

public String getAttachedJavadoc(IProgressMonitor monitor, String encoding) throws JavaModelException {

	URL baseLocation= getJavadocBaseLocation();

	if (baseLocation == null) {

		return null;

	}

	StringBuffer pathBuffer = new StringBuffer(baseLocation.toExternalForm());

	if (!(pathBuffer.charAt(pathBuffer.length() - 1) == '/')) {

		pathBuffer.append('/');

	}

	String packPath= this.getElementName().replace('.', '/');

	pathBuffer.append(packPath).append('/').append(JavadocConstants.PACKAGE_FILE_NAME);

	final String contents = getURLContents(String.valueOf(pathBuffer), encoding);

	if (contents == null) throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.CANNOT_RETRIEVE_ATTACHED_JAVADOC, this));

	return contents;

}

import java.net.URL;

import java.util.ArrayList;

import java.util.StringTokenizer;

import org.eclipse.core.runtime.IProgressMonitor;

import org.eclipse.core.runtime.NullProgressMonitor;

		if (this.parameterNames == null) {

			// try to see if we can retrieve the names from the attached javadoc

			IBinaryMethod info = (IBinaryMethod) getElementInfo();

			final int paramCount = Signature.getParameterCount(new String(info.getMethodDescriptor()));

			if (paramCount != 0) {

				String javadoc = this.getAttachedJavadoc(new NullProgressMonitor(), "UTF-8"); //$NON-NLS-1$

				if (javadoc != null) {

					final int indexOfOpenParen = javadoc.indexOf('(');

					if (indexOfOpenParen != -1) {

						final int indexOfClosingParen = javadoc.indexOf(')', indexOfOpenParen);

						if (indexOfClosingParen != -1) {

							final char[] paramsSource =

								CharOperation.replace(

									javadoc.substring(indexOfOpenParen + 1, indexOfClosingParen).toCharArray(),

									" ".toCharArray(), //$NON-NLS-1$

									new char[] {' '});

							final StringTokenizer tokenizer = new StringTokenizer(String.valueOf(paramsSource), ", \n\r"); //$NON-NLS-1$

							int index = 0;

							final ArrayList paramNames = new ArrayList(paramCount);

							while (tokenizer.hasMoreTokens()) {

								final String token = tokenizer.nextToken();

								if ((index & 1) != 0) {

									// if odd then this is a parameter name

									paramNames.add(token);

								}

								index++;

							}

							if (!paramNames.isEmpty()) {

								this.parameterNames = new String[paramNames.size()];

								paramNames.toArray(this.parameterNames);

							}

	 					}

					}

				}

			}

		}

public String getAttachedJavadoc(IProgressMonitor monitor, String encoding) throws JavaModelException {

	URL baseLocation= getJavadocBaseLocation();

	if (baseLocation == null) {

		return null;

	}

	StringBuffer pathBuffer = new StringBuffer(baseLocation.toExternalForm());

	if (!(pathBuffer.charAt(pathBuffer.length() - 1) == '/')) {

		pathBuffer.append('/');

	}

	IType declaringType = this.getDeclaringType();

	IPackageFragment pack= declaringType.getPackageFragment();

	String typeQualifiedName = declaringType.getTypeQualifiedName('.');

	typeQualifiedName = typeQualifiedName.replace('$', '.');

	pathBuffer.append(pack.getElementName().replace('.', '/')).append('/').append(typeQualifiedName).append(JavadocConstants.HTML_EXTENSION);

	String methodName = this.getElementName();

	if (this.isConstructor()) {

		methodName = typeQualifiedName;

	}

	String anchor = Signature.toString(this.getSignature().replace('/', '.'), methodName, null, true, false);

	if (declaringType.isMember()) {

		int depth = 0;

		final String packageFragmentName = declaringType.getPackageFragment().getElementName();

		// might need to remove a part of the signature corresponding to the synthetic argument

		final IJavaProject javaProject = declaringType.getJavaProject();

		char[][] typeNames = CharOperation.splitOn('.', typeQualifiedName.toCharArray());

		if (!Flags.isStatic(declaringType.getFlags())) depth++;

		StringBuffer typeName = new StringBuffer();

		for (int i = 0, max = typeNames.length; i < max; i++) {

			if (typeName.length() == 0) {

				typeName.append(typeNames[i]);

			} else {

				typeName.append('.').append(typeNames[i]);

			}

			IType resolvedType = javaProject.findType(packageFragmentName, String.valueOf(typeName));

			if (resolvedType != null && resolvedType.isMember() && !Flags.isStatic(resolvedType.getFlags())) depth++;

		}

		if (depth != 0) {

			int indexOfOpeningParen = anchor.indexOf('(');

			if (indexOfOpeningParen == -1) return null;

			int index = indexOfOpeningParen;

			indexOfOpeningParen++;

			for (int i = 0; i < depth; i++) {

				int indexOfComma = anchor.indexOf(',', index);

				if (indexOfComma != -1) {

					index = indexOfComma + 2;

				}

			}

			anchor = anchor.substring(0, indexOfOpeningParen) + anchor.substring(index);

		}

	}

	final String contents = getURLContents(String.valueOf(pathBuffer), encoding);

	if (contents == null) throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.CANNOT_RETRIEVE_ATTACHED_JAVADOC, this));

	int indexAnchor = contents.indexOf(JavadocConstants.ANCHOR_PREFIX_START + anchor + JavadocConstants.ANCHOR_PREFIX_END);

	if (indexAnchor == -1) throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.UNRECOGNIZED_JAVADOC_FORMAT, this));

	int indexOfEndLink = contents.indexOf(JavadocConstants.ANCHOR_SUFFIX, indexAnchor);

	if (indexOfEndLink == -1) throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.UNRECOGNIZED_JAVADOC_FORMAT, this));

	int indexOfNextMethod = contents.indexOf(JavadocConstants.ANCHOR_PREFIX_START, indexOfEndLink);

	// find bottom

	int indexOfBottom = -1;

	if (this.isConstructor()) {

		indexOfBottom = contents.indexOf(JavadocConstants.METHOD_DETAIL, indexOfEndLink);

		if (indexOfBottom == -1) {

			indexOfBottom = contents.indexOf(JavadocConstants.END_OF_CLASS_DATA, indexOfEndLink);

		}

	} else {

		indexOfBottom = contents.indexOf(JavadocConstants.END_OF_CLASS_DATA, indexOfEndLink);

	}

	if (indexOfBottom == -1) throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.UNRECOGNIZED_JAVADOC_FORMAT, this));

	indexOfNextMethod = Math.min(indexOfNextMethod, indexOfBottom);

	if (indexOfNextMethod == -1) throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.UNRECOGNIZED_JAVADOC_FORMAT, this));

	return contents.substring(indexOfEndLink + JavadocConstants.ANCHOR_SUFFIX_LENGTH, indexOfNextMethod);

}

import java.net.URL;

public String getAttachedJavadoc(IProgressMonitor monitor, String encoding) throws JavaModelException {

	URL baseLocation= getJavadocBaseLocation();

	if (baseLocation == null) {

		return null;

	}

	StringBuffer pathBuffer = new StringBuffer(baseLocation.toExternalForm());

	if (!(pathBuffer.charAt(pathBuffer.length() - 1) == '/')) {

		pathBuffer.append('/');

	}

	IPackageFragment pack= this.getPackageFragment();

	String typeQualifiedName = this.getTypeQualifiedName('.');

	typeQualifiedName = typeQualifiedName.replace('$', '.');

	pathBuffer.append(pack.getElementName().replace('.', '/')).append('/').append(typeQualifiedName).append(JavadocConstants.HTML_EXTENSION);

	final String contents = getURLContents(String.valueOf(pathBuffer), encoding);

	if (contents == null) throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.CANNOT_RETRIEVE_ATTACHED_JAVADOC, this));

	final int indexOfStartOfClassData = contents.indexOf(JavadocConstants.START_OF_CLASS_DATA);

	if (indexOfStartOfClassData == -1) throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.UNRECOGNIZED_JAVADOC_FORMAT, this));

	int indexOfNextSummary = contents.indexOf(JavadocConstants.NESTED_CLASS_SUMMARY);

	if (indexOfNextSummary == -1) {

		// try to find constructor summary start

		indexOfNextSummary = contents.indexOf(JavadocConstants.CONSTRUCTOR_SUMMARY);

	}

	if (indexOfNextSummary == -1) {

		// try to find method summary start

		indexOfNextSummary = contents.indexOf(JavadocConstants.METHOD_SUMMARY);

	}

	if (indexOfNextSummary == -1) {

		// we take the end of class data

		indexOfNextSummary = contents.indexOf(JavadocConstants.END_OF_CLASS_DATA);

	}

	if (indexOfNextSummary == -1) {

		throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.UNRECOGNIZED_JAVADOC_FORMAT, this));

	}

	return contents.substring(indexOfStartOfClassData + JavadocConstants.START_OF_CLASS_DATA_LENGTH, indexOfNextSummary);

}

import java.io.IOException;

import java.io.InputStream;

import java.net.MalformedURLException;

import java.net.URL;

import java.net.URLConnection;

//	private static final QualifiedName PROJECT_JAVADOC= new QualifiedName(JavaCore.PLUGIN_ID, "project_javadoc_location"); //$NON-NLS-1$

	protected URL getJavadocBaseLocation() throws JavaModelException {

		IPackageFragmentRoot root= (IPackageFragmentRoot) this.getAncestor(IJavaElement.PACKAGE_FRAGMENT_ROOT);

		if (root == null) {

			return null;

		}

		if (root.getKind() == IPackageFragmentRoot.K_BINARY) {

			IClasspathEntry entry= root.getRawClasspathEntry();

			if (entry == null) {

				return null;

			}

			if (entry.getEntryKind() == IClasspathEntry.CPE_CONTAINER) {

				entry= getRealClasspathEntry(root.getJavaProject(), entry.getPath(), root.getPath());

				if (entry == null) {

					return null;

				}

			}

			return getLibraryJavadocLocation(entry);

		}

		return null;

	}

	private static IClasspathEntry getRealClasspathEntry(IJavaProject jproject, IPath containerPath, IPath libPath) throws JavaModelException {

		IClasspathContainer container= JavaCore.getClasspathContainer(containerPath, jproject);

		if (container != null) {

			IClasspathEntry[] entries= container.getClasspathEntries();

			for (int i= 0; i < entries.length; i++) {

				IClasspathEntry curr= entries[i];

				IClasspathEntry resolved= JavaCore.getResolvedClasspathEntry(curr);

				if (resolved != null && libPath.equals(resolved.getPath())) {

					return curr; // return the real entry

				}

			}

		}

		return null; // not found

	}

	public static URL getLibraryJavadocLocation(IClasspathEntry entry) throws JavaModelException {

		switch(entry.getEntryKind()) {

			case IClasspathEntry.CPE_LIBRARY :

			case IClasspathEntry.CPE_VARIABLE :

				break;

			default :

				throw new IllegalArgumentException("Entry must be of kind CPE_LIBRARY or CPE_VARIABLE"); //$NON-NLS-1$

		}

		IClasspathAttribute[] extraAttributes= entry.getExtraAttributes();

		for (int i= 0; i < extraAttributes.length; i++) {

			IClasspathAttribute attrib= extraAttributes[i];

			if (IClasspathAttribute.JAVADOC_LOCATION_ATTRIBUTE_NAME.equals(attrib.getName())) {

				try {

					return new URL(attrib.getValue());

				} catch (MalformedURLException e) {

					throw new JavaModelException(new JavaModelStatus(IJavaModelStatusConstants.CANNOT_RETRIEVE_ATTACHED_JAVADOC));

				}

			}

		}

		return null;

	}

	/*

	 * @see IJavaElement#getAttachedJavadoc(IProgressMonitor)

	 */

	public String getAttachedJavadoc(IProgressMonitor monitor, String encoding) throws JavaModelException {

		return null;

	}

	protected String getURLContents(String docUrlValue, String encoding) throws JavaModelException {

		try {

			URL docUrl = new URL(docUrlValue);

			URLConnection connection = docUrl.openConnection();

			String contentEncoding = connection.getContentEncoding();

			if (contentEncoding != null) {

				InputStream stream = docUrl.openStream();

				char[] contents = org.eclipse.jdt.internal.compiler.util.Util.getInputStreamAsCharArray(stream, -1, contentEncoding);

				if (contents != null) {

					return String.valueOf(contents);

				}

			} else {

				InputStream stream = docUrl.openStream();

				char[] contents = org.eclipse.jdt.internal.compiler.util.Util.getInputStreamAsCharArray(stream, -1, encoding);

				if (contents != null) {

					return String.valueOf(contents);

				}

			}

 		} catch (MalformedURLException e) {

 			// ignore

		} catch (IOException e) {

			// ignore

		}

		return null;

	}

package org.eclipse.jdt.internal.core;

public interface JavadocConstants {

	String ANCHOR_PREFIX_END = "\""; //$NON-NLS-1$

	String ANCHOR_PREFIX_START = "<A NAME=\""; //$NON-NLS-1$

	String ANCHOR_SUFFIX = "</A>"; //$NON-NLS-1$

	int ANCHOR_SUFFIX_LENGTH = JavadocConstants.ANCHOR_SUFFIX.length();

	String CONSTRUCTOR_DETAIL = "<!-- ========= CONSTRUCTOR DETAIL ======== -->"; //$NON-NLS-1$

	String CONSTRUCTOR_SUMMARY = "<!-- ======== CONSTRUCTOR SUMMARY ======== -->"; //$NON-NLS-1$

	String END_OF_CLASS_DATA = "<!-- ========= END OF CLASS DATA ========= -->"; //$NON-NLS-1$

	String HTML_EXTENSION = ".html"; //$NON-NLS-1$

	String INDEX_FILE_NAME = "index.html"; //$NON-NLS-1$

	String METHOD_DETAIL = "<!-- ============ METHOD DETAIL ========== -->"; //$NON-NLS-1$

	String METHOD_SUMMARY = "<!-- ========== METHOD SUMMARY =========== -->"; //$NON-NLS-1$

	String NESTED_CLASS_SUMMARY = "<!-- ======== NESTED CLASS SUMMARY ======== -->"; //$NON-NLS-1$

	String PACKAGE_FILE_NAME = "package-summary.html"; //$NON-NLS-1$

	String START_OF_CLASS_DATA = "<!-- ======== START OF CLASS DATA ======== -->"; //$NON-NLS-1$

	int START_OF_CLASS_DATA_LENGTH = JavadocConstants.START_OF_CLASS_DATA.length();

}