Top Description Inners Fields Constructors Methods
com.thoughtworks.paranamer

public Class JavadocParanamer

extends Object
implements Paranamer
Class Inheritance
All Implemented Interfaces
com.thoughtworks.paranamer.Paranamer
Imports
java.io.*, java.lang.reflect.AccessibleObject, .Constructor, .Member, .Method, java.net.URL, .URLConnection, java.util.Enumeration, java.util.regex.Matcher, .Pattern, java.util.zip.ZipEntry, .ZipFile

Accesses Javadocs to extract parameter names. Supports:-
Author
Samuel Halliday

Nested and Inner Type Summary

Modifier and TypeClass and Description
protected static class
protected static interface
protected static class
protected static class

Field Summary

Modifier and TypeField and Description
private final JavadocParanamer.JavadocProvider

Constructor Summary

AccessConstructor and Description
public
JavadocParanamer(File
either a zip archive or base directory of Javadocs.
archiveOrDirectory
)

public
JavadocParanamer(URL
base URL of the JavaDocs
url
)

Method Summary

Modifier and TypeMethod and Description
protected static String
private String[]
protected static String
private String[]
private String[]
public String[]
lookupParameterNames(AccessibleObject
the Method or Constructor for which the parameter names are looked up.
accessible
)

Implements com.thoughtworks.paranamer.Paranamer.lookupParameterNames.

Lookup the parameter names of a given method.
public String[]
lookupParameterNames(AccessibleObject
the Method or Constructor for which the parameter names are looked up.
accessible
,
boolean
whether to throw an exception if no Paranamer data found (versus return null).
throwExceptionIfMissing
)

Implements com.thoughtworks.paranamer.Paranamer.lookupParameterNames.

Lookup the parameter names of a given method.
protected static String
protected static InputStream
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

providerback to summary
private final JavadocParanamer.JavadocProvider provider

Constructor Detail

JavadocParanamerback to summary
public JavadocParanamer(File archiveOrDirectory) throws IOException
Parameters
archiveOrDirectory:File

either a zip archive or base directory of Javadocs.

Exceptions
FileNotFoundException:
if the parameter or package-list cannot be found.
JavadocParanamerback to summary
public JavadocParanamer(URL url) throws IOException
Parameters
url:URL

base URL of the JavaDocs

Exceptions
FileNotFoundException:
if the url does not have a /package-list

Method Detail

getCanonicalNameback to summary
protected static String getCanonicalName(Class<?> klass)
getConstructorParameterNamesback to summary
private String[] getConstructorParameterNames(Constructor<?> cons, String raw)
getJavadocFilenameback to summary
protected static String getJavadocFilename(Member member)
getMethodParameterNamesback to summary
private String[] getMethodParameterNames(Method method, String raw)
getParameterNamesback to summary
private String[] getParameterNames(AccessibleObject a, String name, Class<?>[] types, String raw)
lookupParameterNamesback to summary
public String[] lookupParameterNames(AccessibleObject accessible)

Implements com.thoughtworks.paranamer.Paranamer.lookupParameterNames.

Doc from com.thoughtworks.paranamer.Paranamer.lookupParameterNames.

Lookup the parameter names of a given method.

Parameters
accessible:AccessibleObject

the Method or Constructor for which the parameter names are looked up.

Returns:String[]

A list of the parameter names.

lookupParameterNamesback to summary
public String[] lookupParameterNames(AccessibleObject accessible, boolean throwExceptionIfMissing)

Implements com.thoughtworks.paranamer.Paranamer.lookupParameterNames.

Doc from com.thoughtworks.paranamer.Paranamer.lookupParameterNames.

Lookup the parameter names of a given method.

Parameters
accessible:AccessibleObject

the Method or Constructor for which the parameter names are looked up.

throwExceptionIfMissing:boolean

whether to throw an exception if no Paranamer data found (versus return null).

Returns:String[]

A list of the parameter names.

streamToStringback to summary
protected static String streamToString(InputStream input) throws IOException
urlToStreamback to summary
protected static InputStream urlToStream(URL url) throws IOException
com.thoughtworks.paranamer back to summary

protected Class JavadocParanamer.DirJavadocProvider

extends Object
implements JavadocProvider
Class Inheritance
  • java.lang.Object
  • com.thoughtworks.paranamer.JavadocParanamer.DirJavadocProvider
All Implemented Interfaces
com.thoughtworks.paranamer.JavadocParanamer.JavadocProvider

Field Summary

Modifier and TypeField and Description
private final File

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
public InputStream
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

dirback to summary
private final File dir

Constructor Detail

DirJavadocProviderback to summary
public DirJavadocProvider(File dir) throws IOException

Method Detail

getRawJavadocback to summary
public InputStream getRawJavadoc(String fqn) throws IOException

Implements com.thoughtworks.paranamer.JavadocParanamer.JavadocProvider.getRawJavadoc.

com.thoughtworks.paranamer back to summary

protected Interface JavadocParanamer.JavadocProvider

Known Direct Implementers
com.thoughtworks.paranamer.JavadocParanamer.ZipJavadocProvider, com.thoughtworks.paranamer.JavadocParanamer.UrlJavadocProvider, com.thoughtworks.paranamer.JavadocParanamer.DirJavadocProvider

Method Summary

Modifier and TypeMethod and Description
public InputStream
getRawJavadoc(String canonicalClassName)

Method Detail

getRawJavadocback to summary
public InputStream getRawJavadoc(String canonicalClassName) throws IOException
com.thoughtworks.paranamer back to summary

protected Class JavadocParanamer.UrlJavadocProvider

extends Object
implements JavadocProvider
Class Inheritance
  • java.lang.Object
  • com.thoughtworks.paranamer.JavadocParanamer.UrlJavadocProvider
All Implemented Interfaces
com.thoughtworks.paranamer.JavadocParanamer.JavadocProvider

Field Summary

Modifier and TypeField and Description
private final URL

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
public InputStream
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

baseback to summary
private final URL base

Constructor Detail

UrlJavadocProviderback to summary
public UrlJavadocProvider(URL base) throws IOException

Method Detail

getRawJavadocback to summary
public InputStream getRawJavadoc(String fqn) throws IOException

Implements com.thoughtworks.paranamer.JavadocParanamer.JavadocProvider.getRawJavadoc.

com.thoughtworks.paranamer back to summary

protected Class JavadocParanamer.ZipJavadocProvider

extends Object
implements JavadocProvider
Class Inheritance
  • java.lang.Object
  • com.thoughtworks.paranamer.JavadocParanamer.ZipJavadocProvider
All Implemented Interfaces
com.thoughtworks.paranamer.JavadocParanamer.JavadocProvider

Field Summary

Modifier and TypeField and Description
private final ZipFile

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
private ZipEntry
find(String postfix)

public InputStream
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

zipback to summary
private final ZipFile zip

Constructor Detail

ZipJavadocProviderback to summary
public ZipJavadocProvider(File file) throws IOException

Method Detail

findback to summary
private ZipEntry find(String postfix) throws FileNotFoundException
getRawJavadocback to summary
public InputStream getRawJavadoc(String fqn) throws IOException

Implements com.thoughtworks.paranamer.JavadocParanamer.JavadocProvider.getRawJavadoc.