com.webcohesion.enunciate.modules.objc_client

Class ObjCXMLClientModule

java.lang.Object

com.webcohesion.enunciate.module.BasicEnunicateModule

com.webcohesion.enunciate.module.BasicGeneratingModule

com.webcohesion.enunciate.modules.objc_client.ObjCXMLClientModule

All Implemented Interfaces:

ApiFeatureProviderModule, DependingModuleAwareModule, EnunciateModule

public class ObjCXMLClientModule
extends BasicGeneratingModule
implements ApiFeatureProviderModule

Author:

Ryan Heaton

Field Summary

Fields inherited from class com.webcohesion.enunciate.module.BasicEnunicateModule

config, context, dependingModules, enunciate

Constructor Summary

Constructors

Constructor and Description
ObjCXMLClientModule()

Method Summary

Methods

Modifier and Type	Method and Description
void	call(EnunciateContext context)
Method	findExampleResourceMethod() Finds an example resource method, according to the following preference order: The first method annotated with DocumentationExample.
List<DependencySpec>	getDependencySpecifications()
String	getEnumConstantNamePattern() The pattern for converting an enum constant to a unique C-style type name.
Set<String>	getFacetExcludes()
Set<String>	getFacetIncludes()
String	getName()
String	getPackageIdentifierPattern() The format string creating a package identifier from a package name.
Map<String,String>	getPackageIdentifiers() The package-to-module conversions.
String	getSlug() The label for the Ruby API.
protected File	getSourceDir()
protected URL	getTemplateURL(String template) Get a template URL for the template of the given name.
String	getTranslateIdTo() What to translate 'id' to when writing out objective-c code.
String	getTypeDefinitionNamePattern() The pattern for converting a type definition to a unique C-style type name.
boolean	isSeparateCommonCode() Whether to separate the common code from the project-specific code.
String	processTemplate(URL templateURL, Object model) Processes the specified template with the given model.
protected String	readResource(String resource, Map<String,Object> model, NameForTypeDefinitionMethod nameForTypeDefinition) Reads a resource into string form.
static String	scrubIdentifier(String identifier) Scrub a C identifier (removing any illegal characters, etc.).
protected boolean	usesUnmappableElements()

Methods inherited from class com.webcohesion.enunciate.module.BasicGeneratingModule

buildFileList, getOldest, getYoungest, isUpToDate, isUpToDateWithSources

Methods inherited from class com.webcohesion.enunciate.module.BasicEnunicateModule

acknowledgeDependingModules, capitalize, debug, descriptionOf, info, init, init, isEnabled, positionOf, resolveFile, warn

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.webcohesion.enunciate.module.EnunciateModule

init, init, isEnabled

Constructor Detail

ObjCXMLClientModule

public ObjCXMLClientModule()

Method Detail

getName

public String getName()

Specified by:

getName in interface EnunciateModule

Returns:

"obj-c-xml-client"

getDependencySpecifications

public List<DependencySpec> getDependencySpecifications()

Specified by:

getDependencySpecifications in interface EnunciateModule

Overrides:

getDependencySpecifications in class BasicEnunicateModule

scrubIdentifier

public static String scrubIdentifier(String identifier)

Scrub a C identifier (removing any illegal characters, etc.).

Parameters:

identifier - The identifier.

Returns:

The identifier.

call

public void call(EnunciateContext context)

Specified by:

call in interface EnunciateModule

usesUnmappableElements

protected boolean usesUnmappableElements()

getSourceDir

protected File getSourceDir()

processTemplate

public String processTemplate(URL templateURL,
                     Object model)
                       throws IOException,
                              freemarker.template.TemplateException

Processes the specified template with the given model.

Parameters:

templateURL - The template URL.

model - The root model.

Throws:

IOException

freemarker.template.TemplateException

readResource

protected String readResource(String resource,
                  Map<String,Object> model,
                  NameForTypeDefinitionMethod nameForTypeDefinition)

Reads a resource into string form.

Parameters:

resource - The resource to read.

Returns:

The string form of the resource.

findExampleResourceMethod

public Method findExampleResourceMethod()

Finds an example resource method, according to the following preference order:

1. The first method annotated with DocumentationExample.
2. The first method with BOTH an output payload with a known XML element and an input payload with a known XML element.
3. The first method with an output payload with a known XML element.

Returns:

An example resource method, or if no good examples were found.

getTemplateURL

protected URL getTemplateURL(String template)

Get a template URL for the template of the given name.

Parameters:

template - The specified template.

Returns:

The URL to the specified template.

getSlug

public String getSlug()

The label for the Ruby API.

Returns:

The label for the Ruby API.

getPackageIdentifiers

public Map<String,String> getPackageIdentifiers()

The package-to-module conversions.

Returns:

The package-to-module conversions.

getPackageIdentifierPattern

public String getPackageIdentifierPattern()

The format string creating a package identifier from a package name.

Returns:

The format string creating a package identifier from a package name.

getTypeDefinitionNamePattern

public String getTypeDefinitionNamePattern()

The pattern for converting a type definition to a unique C-style type name.

Returns:

The pattern for converting a type definition to a unique C-style type name.

getEnumConstantNamePattern

public String getEnumConstantNamePattern()

The pattern for converting an enum constant to a unique C-style type name.

Returns:

The pattern for converting an enum constant to a unique C-style type name.

getTranslateIdTo

public String getTranslateIdTo()

What to translate 'id' to when writing out objective-c code.

Returns:

What to translate 'id' to when writing out objective-c code.

isSeparateCommonCode

public boolean isSeparateCommonCode()

Whether to separate the common code from the project-specific code.

Returns:

Whether to separate the common code from the project-specific code.

getFacetIncludes

public Set<String> getFacetIncludes()

getFacetExcludes

public Set<String> getFacetExcludes()