Appendix A. Command Index

This appendix was automatically built from Roo 1.2.5.RELEASE [rev 8341dc2].

Commands are listed in alphabetic order, and are shown in monospaced font with any mandatory options you must specify when using the command. Most commands accept a large number of options, and all of the possible options for each command are presented in this appendix.

A.1. Add On Commands

Add On Commands are contained in org.springframework.roo.addon.roobot.client.AddOnCommands.

A.1.1. addon feedback bundle

Provide anonymous ratings and comments on a Spring Roo Add-on (your feedback will be published publicly)

addon feedback bundle --bundleSymbolicName --rating
--bundleSymbolicName

The bundle symbolic name for the add-on of interest; no default value (mandatory)

--rating

How much did you like this add-on?; no default value (mandatory)

--comment

Your comments on this add-on eg "this is my comment!"; limit of 140 characters; no default value

A.1.2. addon info bundle

Provide information about a specific Spring Roo Add-on

addon info bundle --bundleSymbolicName
--bundleSymbolicName

The bundle symbolic name for the add-on of interest; no default value (mandatory)

A.1.3. addon info id

Provide information about a specific Spring Roo Add-on

addon info id --searchResultId
--searchResultId

The bundle ID as presented via the addon list or addon search command; no default value (mandatory)

A.1.4. addon install bundle

Install Spring Roo Add-on

addon install bundle --bundleSymbolicName
--bundleSymbolicName

The bundle symbolic name for the add-on of interest; no default value (mandatory)

A.1.5. addon install id

Install Spring Roo Add-on

addon install id --searchResultId
--searchResultId

The bundle ID as presented via the addon list or addon search command; no default value (mandatory)

A.1.6. addon list

List all known Spring Roo Add-ons (up to the maximum number displayed on a single page)

addon list
--refresh

Refresh the add-on index from the Internet; default if option present: 'true'; default if option not present: 'false'

--linesPerResult

The maximum number of lines displayed per add-on; default: '2'

--maxResults

The maximum number of add-ons to list; default: '99'

--trustedOnly

Only display trusted add-ons in search results; default if option present: 'true'; default if option not present: 'false'

--communityOnly

Only display community provided add-ons in search results; default if option present: 'true'; default if option not present: 'false'

--compatibleOnly

Only display compatible add-ons in search results; default if option present: 'true'; default if option not present: 'false'

A.1.7. addon remove

Remove Spring Roo Add-on

addon remove --bundleSymbolicName
--bundleSymbolicName

The bundle symbolic name for the add-on of interest; no default value (mandatory)

A.1.8. addon search

Search all known Spring Roo Add-ons

addon search
--requiresDescription

A comma separated list of search terms; default: '*'

--refresh

Refresh the add-on index from the Internet; default if option present: 'true'; default if option not present: 'false'

--linesPerResult

The maximum number of lines displayed per add-on; default: '2'

--maxResults

The maximum number of add-ons to list; default: '20'

--trustedOnly

Only display trusted add-ons in search results; default if option present: 'true'; default if option not present: 'false'

--compatibleOnly

Only display compatible add-ons in search results; default if option present: 'true'; default if option not present: 'false'

--communityOnly

Only display community provided add-ons in search results; default if option present: 'true'; default if option not present: 'false'

--requiresCommand

Only display add-ons in search results that offer this command; no default value

A.1.9. addon upgrade all

Upgrade all relevant Spring Roo Add-ons / Components for the current stability level

addon upgrade all

This command does not accept any options.

A.1.10. addon upgrade available

List available Spring Roo Add-on / Component upgrades

addon upgrade available
--addonStabilityLevel

The stability level of add-ons or components which are presented for upgrading (default: ANY); no default value

A.1.11. addon upgrade bundle

Upgrade a specific Spring Roo Add-on / Component

addon upgrade bundle --bundleSymbolicName
--bundleSymbolicName

The bundle symbolic name for the add-on to upgrade; no default value (mandatory)

A.1.12. addon upgrade id

Upgrade a specific Spring Roo Add-on / Component from a search result ID

addon upgrade id --searchResultId
--searchResultId

The bundle ID as presented via the addon list or addon search command; no default value (mandatory)

A.1.13. addon upgrade settings

Settings for Add-on upgrade operations

addon upgrade settings
--addonStabilityLevel

The stability level of add-ons or components which are presented for upgrading; no default value

A.2. Backup Commands

Backup Commands are contained in org.springframework.roo.addon.backup.BackupCommands.

A.2.1. backup

Backup your project to a zip file

backup

This command does not accept any options.

A.3. Classpath Commands

Classpath Commands are contained in org.springframework.roo.classpath.operations.ClasspathCommands.

A.3.1. class

Creates a new Java class source file in any project path

class --class
--class

The name of the class to create; no default value (mandatory)

--rooAnnotations

Whether the generated class should have common Roo annotations; default if option present: 'true'; default if option not present: 'false'

--path

Source directory to create the class in; default: 'FOCUSED|SRC_MAIN_JAVA'

--extends

The superclass (defaults to java.lang.Object); default if option not present: 'java.lang.Object'

--implements

The interface to implement; no default value

--abstract

Whether the generated class should be marked as abstract; default if option present: 'true'; default if option not present: 'false'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.3.2. constructor

Creates a class constructor

constructor
--class

The name of the class to receive this constructor; default if option not present: '*'

--fields

The fields to include in the constructor. Multiple field names must be a double-quoted list separated by spaces

A.3.3. enum constant

Inserts a new enum constant into an enum

enum constant --name
--class

The name of the enum class to receive this field; default if option not present: '*'

--name

The name of the constant; no default value (mandatory)

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.3.4. enum type

Creates a new Java enum source file in any project path

enum type --class
--class

The name of the enum to create; no default value (mandatory)

--path

Source directory to create the enum in; default: 'FOCUSED|SRC_MAIN_JAVA'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.3.5. focus

Changes focus to a different type

focus --class
--class

The type to focus on; no default value (mandatory)

A.3.6. interface

Creates a new Java interface source file in any project path

interface --class
--class

The name of the interface to create; no default value (mandatory)

--path

Source directory to create the interface in; default: 'FOCUSED|SRC_MAIN_JAVA'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.4. Controller Commands

Controller Commands are contained in org.springframework.roo.addon.web.mvc.controller.ControllerCommands.

A.4.1. controller all

Scaffold controllers for all project entities without an existing controller - deprecated, use 'web mvc setup' + 'web mvc all' instead

controller all --package
--package

The package in which new controllers will be placed; no default value (mandatory)

A.4.2. controller scaffold

Create a new scaffold Controller (ie where we maintain CRUD automatically) - deprecated, use 'web mvc scaffold' instead

controller scaffold --class
--class

The path and name of the controller object to be created; no default value (mandatory)

--entity

The name of the entity object which the controller exposes to the web tier; default if option not present: '*'

--path

The base path under which the controller listens for RESTful requests (defaults to the simple name of the form backing object); no default value

--disallowedOperations

A comma separated list of operations (only create, update, delete allowed) that should not be generated in the controller; no default value

A.4.3. web mvc all

Scaffold Spring MVC controllers for all project entities without an existing controller

web mvc all --package
--package

The package in which new controllers will be placed; no default value (mandatory)

A.4.4. web mvc scaffold

Create a new scaffold Controller (ie where Roo maintains CRUD functionality automatically)

web mvc scaffold --class
--class

The path and name of the controller object to be created; no default value (mandatory)

--backingType

The name of the form backing type which the controller exposes to the web tier; default if option not present: '*'

--path

The base path under which the controller listens for RESTful requests (defaults to the simple name of the form backing object); no default value

--disallowedOperations

A comma separated list of operations (only create, update, delete allowed) that should not be generated in the controller; no default value

A.5. Creator Commands

Creator Commands are contained in org.springframework.roo.addon.creator.CreatorCommands.

A.5.1. addon create advanced

Create a new advanced add-on for Spring Roo (commands + operations + metadata + trigger annotation + dependencies)

addon create advanced --topLevelPackage
--topLevelPackage

The top level package of the new addon; no default value (mandatory)

--description

Description of your addon (surround text with double quotes); no default value

--projectName

Provide a custom project name (if not provided the top level package name will be used instead); no default value

A.5.2. addon create i18n

Create a new Internationalization add-on for Spring Roo

addon create i18n --topLevelPackage --locale --messageBundle
--topLevelPackage

The top level package of the new addon; no default value (mandatory)

--locale

The locale abbreviation (ie: en, or more specific like en_AU, or de_DE); no default value (mandatory)

--messageBundle

Fully qualified path to the messages_xx.properties file; no default value (mandatory)

--language

The full name of the language (used as a label for the UI); no default value

--flagGraphic

Fully qualified path to flag xx.png file; no default value

--description

Description of your addon (surround text with double quotes); no default value

--projectName

Provide a custom project name (if not provided the top level package name will be used instead); no default value

A.5.3. addon create simple

Create a new simple add-on for Spring Roo (commands + operations)

addon create simple --topLevelPackage
--topLevelPackage

The top level package of the new addon; no default value (mandatory)

--description

Description of your addon (surround text with double quotes); no default value

--projectName

Provide a custom project name (if not provided the top level package name will be used instead); no default value

A.5.4. addon create wrapper

Create a new add-on for Spring Roo which wraps a maven artifact to create a OSGi compliant bundle

addon create wrapper --topLevelPackage --groupId --artifactId --version --vendorName --licenseUrl
--topLevelPackage

The top level package of the new wrapper bundle; no default value (mandatory)

--groupId

Dependency group id; no default value (mandatory)

--artifactId

Dependency artifact id); no default value (mandatory)

--version

Dependency version; no default value (mandatory)

--vendorName

Dependency vendor name); no default value (mandatory)

--licenseUrl

Dependency license URL; no default value (mandatory)

--docUrl

Dependency documentation URL; no default value

--description

Description of the bundle (use keywords with #-tags for better search integration); no default value

--projectName

Provide a custom project name (if not provided the top level package name will be used instead); no default value

--osgiImports

Contents of Import-Package in OSGi manifest; no default value

A.6. Data On Demand Commands

Data On Demand Commands are contained in org.springframework.roo.addon.dod.DataOnDemandCommands.

A.6.1. dod

Creates a new data on demand for the specified entity

dod
--entity

The entity which this data on demand class will create and modify as required; default if option not present: '*'

--class

The class which will be created to hold this data on demand provider (defaults to the entity name + 'DataOnDemand'); no default value

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.7. Dbre Commands

Dbre Commands are contained in org.springframework.roo.addon.dbre.DbreCommands.

A.7.1. database introspect

Displays database metadata

database introspect --schema
--schema

The database schema names. Multiple schema names must be a double-quoted list separated by spaces; no default value (mandatory)

--file

The file to save the metadata to; no default value

--enableViews

Display database views; default if option present: 'true'; default if option not present: 'false'

A.7.2. database reverse engineer

Create and update entities based on database metadata

database reverse engineer --schema
--schema

The database schema names. Multiple schema names must be a double-quoted list separated by spaces; no default value (mandatory)

--package

The package in which new entities will be placed; no default value

--testAutomatically

Create automatic integration tests for entities; default if option present: 'true'; default if option not present: 'false'

--enableViews

Reverse engineer database views; default if option present: 'true'; default if option not present: 'false'

--includeTables

The tables to include in reverse engineering. Multiple table names must be a double-quoted list separated by spaces

--excludeTables

The tables to exclude from reverse engineering. Multiple table names must be a double-quoted list separated by spaces

--includeNonPortableAttributes

Include non-portable JPA @Column attributes such as 'columnDefinition'; default if option present: 'true'; default if option not present: 'false'

--disableVersionFields

Disable 'version' field; default if option present: 'true'; default if option not present: 'false'

--disableGeneratedIdentifiers

Disable identifier auto generation; default if option present: 'true'; default if option not present: 'false'

--activeRecord

Generate CRUD active record methods for each entity; default: 'true'

--repository

Generate a repository for each entity; default if option present: 'true'; default if option not present: 'false'

--service

Generate a service for each entity; default if option present: 'true'; default if option not present: 'false'

A.8. Embedded Commands

Embedded Commands are contained in org.springframework.roo.addon.web.mvc.embedded.EmbeddedCommands.

A.8.1. web mvc embed document

Embed a document for your WEB MVC application

web mvc embed document --provider --documentId
--provider

The id of the document; no default value (mandatory)

--documentId

The id of the document; no default value (mandatory)

--viewName

The name of the jspx view; no default value

A.8.2. web mvc embed generic

Embed media by URL into your WEB MVC application

web mvc embed generic --url
--url

The url of the source to be embedded; no default value (mandatory)

--viewName

The name of the jspx view; no default value

A.8.3. web mvc embed map

Embed a map for your WEB MVC application

web mvc embed map --location
--location

The location of the map (ie "Sydney, Australia"); no default value (mandatory)

--viewName

The name of the jspx view; no default value

A.8.4. web mvc embed photos

Embed a photo gallery for your WEB MVC application

web mvc embed photos --provider --userId --albumId
--provider

The provider of the photo gallery; no default value (mandatory)

--userId

The user id; no default value (mandatory)

--albumId

The album id; no default value (mandatory)

--viewName

The name of the jspx view; no default value

A.8.5. web mvc embed stream video

Embed a video stream into your WEB MVC application

web mvc embed stream video --provider --streamId
--provider

The provider of the video stream; no default value (mandatory)

--streamId

The stream id; no default value (mandatory)

--viewName

The name of the jspx view; no default value

A.8.6. web mvc embed twitter

Embed twitter messages into your WEB MVC application

web mvc embed twitter --searchTerm
--searchTerm

The search term to display results for; no default value (mandatory)

--viewName

The name of the jspx view; no default value

A.8.7. web mvc embed video

Embed a video for your WEB MVC application

web mvc embed video --provider --videoId
--provider

The id of the video; no default value (mandatory)

--videoId

The id of the video; no default value (mandatory)

--viewName

The name of the jspx view; no default value

A.8.8. web mvc embed wave

Embed Google wave integration for your WEB MVC application

web mvc embed wave --waveId
--waveId

The key of the wave; no default value (mandatory)

--viewName

The name of the jspx view; no default value

A.9. Equals Commands

Equals Commands are contained in org.springframework.roo.addon.equals.EqualsCommands.

A.9.1. equals

Add equals and hashCode methods to a class

equals
--class

The name of the class; default if option not present: '*'

--appendSuper

Whether to call the super class equals and hashCode methods; default if option present: 'true'; default if option not present: 'false'

--excludeFields

The fields to exclude in the equals and hashcode methods. Multiple field names must be a double-quoted list separated by spaces

A.10. Felix Delegator

Felix Delegator are contained in org.springframework.roo.felix.FelixDelegator.

A.10.1. exit

Exits the shell

exit

This command does not accept any options.

A.10.2. osgi find

Finds bundles by name

osgi find --bundleSymbolicName
--bundleSymbolicName

A bundle symbolic name to find; no default value (mandatory)

A.10.3. osgi framework command

Passes a command directly through to the Felix shell infrastructure

osgi framework command
--[default]

The command to pass to Felix (WARNING: no validation or security checks are performed); default: 'help'

A.10.4. osgi headers

Display headers for a specific bundle

osgi headers
--bundleSymbolicName

Limit results to a specific bundle symbolic name; no default value

A.10.5. osgi install

Installs a bundle JAR from a given URL

osgi install --url
--url

The URL to obtain the bundle from; no default value (mandatory)

A.10.6. osgi log

Displays the OSGi log information

osgi log
--maximumEntries

The maximum number of log messages to display; no default value

--level

The minimum level of messages to display; no default value

A.10.7. osgi obr deploy

Deploys a specific OSGi Bundle Repository (OBR) bundle

osgi obr deploy --bundleSymbolicName
--bundleSymbolicName

The specific bundle to deploy; no default value (mandatory)

A.10.8. osgi obr info

Displays information on a specific OSGi Bundle Repository (OBR) bundle

osgi obr info --bundleSymbolicName
--bundleSymbolicName

The specific bundle to display information for; no default value (mandatory)

A.10.9. osgi obr list

Lists all available bundles from the OSGi Bundle Repository (OBR) system

osgi obr list
--keywords

Keywords to locate; no default value

A.10.10. osgi obr start

Starts a specific OSGi Bundle Repository (OBR) bundle

osgi obr start --bundleSymbolicName
--bundleSymbolicName

The specific bundle to start; no default value (mandatory)

A.10.11. osgi obr url add

Adds a new OSGi Bundle Repository (OBR) repository file URL

osgi obr url add --url
--url

The URL to add (eg http://felix.apache.org/obr/releases.xml); no default value (mandatory)

A.10.12. osgi obr url list

Lists the currently-configured OSGi Bundle Repository (OBR) repository file URLs

osgi obr url list

This command does not accept any options.

A.10.13. osgi obr url refresh

Refreshes an existing OSGi Bundle Repository (OBR) repository file URL

osgi obr url refresh --url
--url

The URL to refresh (list existing URLs via 'osgi obr url list'); no default value (mandatory)

A.10.14. osgi obr url remove

Removes an existing OSGi Bundle Repository (OBR) repository file URL

osgi obr url remove --url
--url

The URL to remove (list existing URLs via 'osgi obr url list'); no default value (mandatory)

A.10.15. osgi ps

Displays OSGi bundle information

osgi ps
--format

The format of bundle information; default: 'BUNDLE_NAME'

A.10.16. osgi resolve

Resolves a specific bundle ID

osgi resolve --bundleSymbolicName
--bundleSymbolicName

The specific bundle to resolve; no default value (mandatory)

A.10.17. osgi scr config

Lists the current SCR configuration

osgi scr config

This command does not accept any options.

A.10.18. osgi scr disable

Disables a specific SCR-defined component

osgi scr disable --componentId
--componentId

The specific component identifier (use 'osgi scr list' to list component identifiers); no default value (mandatory)

A.10.19. osgi scr enable

Enables a specific SCR-defined component

osgi scr enable --componentId
--componentId

The specific component identifier (use 'osgi scr list' to list component identifiers); no default value (mandatory)

A.10.20. osgi scr info

Lists information about a specific SCR-defined component

osgi scr info --componentId
--componentId

The specific component identifier (use 'osgi scr list' to list component identifiers); no default value (mandatory)

A.10.21. osgi scr list

Lists all SCR-defined components

osgi scr list
--bundleId

Limit results to a specific bundle; no default value

A.10.22. osgi start

Starts a bundle JAR from a given URL

osgi start --url
--url

The URL to obtain the bundle from; no default value (mandatory)

A.10.23. osgi uninstall

Uninstalls a specific bundle

osgi uninstall --bundleSymbolicName
--bundleSymbolicName

The specific bundle to uninstall; no default value (mandatory)

A.10.24. osgi update

Updates a specific bundle

osgi update --bundleSymbolicName
--bundleSymbolicName

The specific bundle to update ; no default value (mandatory)

--url

The URL to obtain the updated bundle from; no default value

A.10.25. osgi version

Displays OSGi framework version

osgi version

This command does not accept any options.

A.11. Field Commands

Field Commands are contained in org.springframework.roo.classpath.operations.FieldCommands.

A.11.1. field boolean

Adds a private boolean field to an existing Java source file

field boolean --fieldName
--fieldName

The name of the field to add; no default value (mandatory)

--class

The name of the class to receive this field; default if option not present: '*'

--notNull

Whether this value cannot be null; default if option present: 'true'; default if option not present: 'false'

--nullRequired

Whether this value must be null; default if option present: 'true'; default if option not present: 'false'

--assertFalse

Whether this value must assert false; default if option present: 'true'; default if option not present: 'false'

--assertTrue

Whether this value must assert true; default if option present: 'true'; default if option not present: 'false'

--column

The JPA @Column name; no default value

--value

Inserts an optional Spring @Value annotation with the given content; no default value

--comment

An optional comment for JavaDocs; no default value

--primitive

Indicates to use a primitive type; default if option present: 'true'; default if option not present: 'false'

--transient

Indicates to mark the field as transient; default if option present: 'true'; default if option not present: 'false'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.11.2. field date

Adds a private date field to an existing Java source file

field date --fieldName --type
--fieldName

The name of the field to add; no default value (mandatory)

--type

The Java type of the entity; no default value (mandatory)

--persistenceType

The type of persistent storage to be used; no default value

--class

The name of the class to receive this field; default if option not present: '*'

--notNull

Whether this value cannot be null; default if option present: 'true'; default if option not present: 'false'

--nullRequired

Whether this value must be null; default if option present: 'true'; default if option not present: 'false'

--future

Whether this value must be in the future; default if option present: 'true'; default if option not present: 'false'

--past

Whether this value must be in the past; default if option present: 'true'; default if option not present: 'false'

--column

The JPA @Column name; no default value

--comment

An optional comment for JavaDocs; no default value

--value

Inserts an optional Spring @Value annotation with the given content; no default value

--transient

Indicates to mark the field as transient; default if option present: 'true'; default if option not present: 'false'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

--dateFormat

Indicates the style of the date format (ignored if dateTimeFormatPattern is specified); default: 'MEDIUM'

--timeFormat

Indicates the style of the time format (ignored if dateTimeFormatPattern is specified); default: 'NONE'

--dateTimeFormatPattern

Indicates a DateTime format pattern such as yyyy-MM-dd hh:mm:ss a; no default value

A.11.3. field embedded

Adds a private @Embedded field to an existing Java source file

field embedded --fieldName --type
--fieldName

The name of the field to add; no default value (mandatory)

--type

The Java type of the @Embeddable class; no default value (mandatory)

--class

The name of the @Entity class to receive this field; default if option not present: '*'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.11.4. field enum

Adds a private enum field to an existing Java source file

field enum --fieldName --type
--fieldName

The name of the field to add; no default value (mandatory)

--type

The enum type of this field; no default value (mandatory)

--class

The name of the class to receive this field; default if option not present: '*'

--column

The JPA @Column name; no default value

--notNull

Whether this value cannot be null; default if option present: 'true'; default if option not present: 'false'

--nullRequired

Whether this value must be null; default if option present: 'true'; default if option not present: 'false'

--enumType

The fetch semantics at a JPA level; no default value

--comment

An optional comment for JavaDocs; no default value

--transient

Indicates to mark the field as transient; default if option present: 'true'; default if option not present: 'false'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.11.5. field file

Adds a byte array field for storing uploaded file contents (JSF-scaffolded UIs only)

field file --fieldName --contentType
--fieldName

The name of the file upload field to add; no default value (mandatory)

--class

The name of the class to receive this field; default if option not present: '*'

--contentType

The content type of the file; no default value (mandatory)

--autoUpload

Whether the file is uploaded automatically when selected; default if option present: 'true'; default if option not present: 'false'

--column

The JPA @Column name; no default value

--notNull

Whether this value cannot be null; default if option present: 'true'; default if option not present: 'false'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.11.6. field list

Adds a private List field to an existing Java source file (eg the 'one' side of a many-to-one)

field list --fieldName --type
--fieldName

The name of the field to add; no default value (mandatory)

--type

The entity which will be contained within the Set; no default value (mandatory)

--class

The name of the class to receive this field; default if option not present: '*'

--mappedBy

The field name on the referenced type which owns the relationship; no default value

--notNull

Whether this value cannot be null; default if option present: 'true'; default if option not present: 'false'

--nullRequired

Whether this value must be null; default if option present: 'true'; default if option not present: 'false'

--sizeMin

The minimum number of elements in the collection; no default value

--sizeMax

The maximum number of elements in the collection; no default value

--cardinality

The relationship cardinality at a JPA level; default: 'MANY_TO_MANY'

--fetch

The fetch semantics at a JPA level; no default value

--comment

An optional comment for JavaDocs; no default value

--transient

Indicates to mark the field as transient; default if option present: 'true'; default if option not present: 'false'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.11.7. field number

Adds a private numeric field to an existing Java source file

field number --fieldName --type
--fieldName

The name of the field to add; no default value (mandatory)

--type

The Java type of the entity; no default value (mandatory)

--class

The name of the class to receive this field; default if option not present: '*'

--notNull

Whether this value cannot be null; default if option present: 'true'; default if option not present: 'false'

--nullRequired

Whether this value must be null; default if option present: 'true'; default if option not present: 'false'

--decimalMin

The BigDecimal string-based representation of the minimum value; no default value

--decimalMax

The BigDecimal string based representation of the maximum value; no default value

--digitsInteger

Maximum number of integral digits accepted for this number; no default value

--digitsFraction

Maximum number of fractional digits accepted for this number; no default value

--min

The minimum value; no default value

--max

The maximum value; no default value

--column

The JPA @Column name; no default value

--comment

An optional comment for JavaDocs; no default value

--value

Inserts an optional Spring @Value annotation with the given content; no default value

--transient

Indicates to mark the field as transient; default if option present: 'true'; default if option not present: 'false'

--primitive

Indicates to use a primitive type if possible; default if option present: 'true'; default if option not present: 'false'

--unique

Indicates whether to mark the field with a unique constraint; default if option present: 'true'; default if option not present: 'false'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.11.8. field other

Inserts a private field into the specified file

field other --fieldName --type
--fieldName

The name of the field; no default value (mandatory)

--type

The Java type of this field; no default value (mandatory)

--class

The name of the class to receive this field; default if option not present: '*'

--notNull

Whether this value cannot be null; default if option present: 'true'; default if option not present: 'false'

--nullRequired

Whether this value must be null; default if option present: 'true'; default if option not present: 'false'

--comment

An optional comment for JavaDocs; no default value

--column

The JPA @Column name; no default value

--value

Inserts an optional Spring @Value annotation with the given content; no default value

--transient

Indicates to mark the field as transient; default if option present: 'true'; default if option not present: 'false'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.11.9. field reference

Adds a private reference field to an existing Java source file (eg the 'many' side of a many-to-one)

field reference --fieldName --type
--fieldName

The name of the field to add; no default value (mandatory)

--type

The Java type of the entity to reference; no default value (mandatory)

--class

The name of the class to receive this field; default if option not present: '*'

--notNull

Whether this value cannot be null; default if option present: 'true'; default if option not present: 'false'

--nullRequired

Whether this value must be null; default if option present: 'true'; default if option not present: 'false'

--joinColumnName

The JPA @JoinColumn name; no default value

--referencedColumnName

The JPA @JoinColumn referencedColumnName; no default value

--cardinality

The relationship cardinality at a JPA level; default: 'MANY_TO_ONE'

--fetch

The fetch semantics at a JPA level; no default value

--comment

An optional comment for JavaDocs; no default value

--transient

Indicates to mark the field as transient; default if option present: 'true'; default if option not present: 'false'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.11.10. field set

Adds a private Set field to an existing Java source file (eg the 'one' side of a many-to-one)

field set --fieldName --type
--fieldName

The name of the field to add; no default value (mandatory)

--type

The entity which will be contained within the Set; no default value (mandatory)

--class

The name of the class to receive this field; default if option not present: '*'

--mappedBy

The field name on the referenced type which owns the relationship; no default value

--notNull

Whether this value cannot be null; default if option present: 'true'; default if option not present: 'false'

--nullRequired

Whether this value must be null; default if option present: 'true'; default if option not present: 'false'

--sizeMin

The minimum number of elements in the collection; no default value

--sizeMax

The maximum number of elements in the collection; no default value

--cardinality

The relationship cardinality at a JPA level; default: 'MANY_TO_MANY'

--fetch

The fetch semantics at a JPA level; no default value

--comment

An optional comment for JavaDocs; no default value

--transient

Indicates to mark the field as transient; default if option present: 'true'; default if option not present: 'false'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.11.11. field string

Adds a private string field to an existing Java source file

field string --fieldName
--fieldName

The name of the field to add; no default value (mandatory)

--class

The name of the class to receive this field; default if option not present: '*'

--notNull

Whether this value cannot be null; default if option present: 'true'; default if option not present: 'false'

--nullRequired

Whether this value must be null; default if option present: 'true'; default if option not present: 'false'

--decimalMin

The BigDecimal string-based representation of the minimum value; no default value

--decimalMax

The BigDecimal string based representation of the maximum value; no default value

--sizeMin

The minimum string length; no default value

--sizeMax

The maximum string length; no default value

--regexp

The required regular expression pattern; no default value

--column

The JPA @Column name; no default value

--value

Inserts an optional Spring @Value annotation with the given content; no default value

--comment

An optional comment for JavaDocs; no default value

--transient

Indicates to mark the field as transient; default if option present: 'true'; default if option not present: 'false'

--unique

Indicates whether to mark the field with a unique constraint; default if option present: 'true'; default if option not present: 'false'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

--lob

Indicates that this field is a Large Object; default if option present: 'true'; default if option not present: 'false'

A.12. Finder Commands

Finder Commands are contained in org.springframework.roo.addon.finder.FinderCommands.

A.12.1. finder add

Install finders in the given target (must be an entity)

finder add --finderName
--class

The controller or entity for which the finders are generated; default if option not present: '*'

--finderName

The finder string as generated with the 'finder list' command; no default value (mandatory)

A.12.2. finder list

List all finders for a given target (must be an entity)

finder list
--class

The controller or entity for which the finders are generated; default if option not present: '*'

--depth

The depth of attribute combinations to be generated for the finders; default: '1'

--filter

A comma separated list of strings that must be present in a filter to be included; no default value

A.13. Gwt Commands

Gwt Commands are contained in org.springframework.roo.addon.gwt.GwtCommands.

A.13.1. gwt setup

Install Google Web Toolkit (GWT) into your project - deprecated, use 'web gwt setup' instead

gwt setup

This command does not accept any options.

A.13.2. web gwt all

Locates all entities in the project and creates GWT requests, proxies and creates the scaffold

web gwt all --proxyPackage --requestPackage
--proxyPackage

The package in which created proxies will be placed; no default value (mandatory)

--requestPackage

The package in which created requests will be placed; no default value (mandatory)

A.13.3. web gwt gae update

Updates the GWT project to support GAE

web gwt gae update

This command does not accept any options.

A.13.4. web gwt proxy all

Locates all entities in the project and creates GWT proxies

web gwt proxy all --package
--package

The package in which created proxies will be placed; no default value (mandatory)

A.13.5. web gwt proxy request all

Locates all entities in the project and creates GWT requests and proxies

web gwt proxy request all --package
--package

The package in which created proxies and requests will be placed; no default value (mandatory)

A.13.6. web gwt proxy request type

Creates a proxy and request based on the specified type

web gwt proxy request type --package --type
--package

The package in which created proxies and requests will be placed; no default value (mandatory)

--type

The type to base the created proxy and request on; no default value (mandatory)

A.13.7. web gwt proxy type

Creates a GWT proxy based on the specified type

web gwt proxy type --package --type
--package

The package in which created proxies will be placed; no default value (mandatory)

--type

The type to base the created request on; no default value (mandatory)

A.13.8. web gwt request all

Locates all entities in the project and creates GWT requests

web gwt request all --package
--package

The package in which created requests will be placed; no default value (mandatory)

A.13.9. web gwt request type

Creates a GWT proxy based on the specified type

web gwt request type --package --type
--package

The package in which created requests will be placed; no default value (mandatory)

--type

The type to base the created request on; no default value (mandatory)

A.13.10. web gwt scaffold

Creates a GWT request, proxy and scaffold for the specified

web gwt scaffold --proxyPackage --requestPackage --type
--proxyPackage

The package in which created proxies will be placed; no default value (mandatory)

--requestPackage

The package in which created requests will be placed; no default value (mandatory)

--type

The type to base the created scaffold on; no default value (mandatory)

A.13.11. web gwt setup

Install Google Web Toolkit (GWT) into your project

web gwt setup

This command does not accept any options.

A.14. Hint Commands

Hint Commands are contained in org.springframework.roo.classpath.operations.HintCommands.

A.14.1. hint

Provides step-by-step hints and context-sensitive guidance

hint
--topic

The topic for which advice should be provided

A.15. Integration Test Commands

Integration Test Commands are contained in org.springframework.roo.addon.test.IntegrationTestCommands.

A.15.1. test integration

Creates a new integration test for the specified entity

test integration
--entity

The name of the entity to create an integration test for; default if option not present: '*'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

--transactional

Indicates whether the created test cases should be run withing a Spring transaction; default: 'true'

A.15.2. test mock

Creates a mock test for the specified entity

test mock
--entity

The name of the entity this mock test is targeting; default if option not present: '*'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.15.3. test stub

Creates a test stub for the specified class

test stub
--class

The name of the class this mock test is targeting; default if option not present: '*'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.16. J Line Shell Component

J Line Shell Component are contained in org.springframework.roo.shell.jline.osgi.JLineShellComponent.

A.16.1. */

End of block comment

*/

This command does not accept any options.

A.16.2. /*

Start of block comment

/*

This command does not accept any options.

A.16.3. //

Inline comment markers (start of line only)

//

This command does not accept any options.

A.16.4. date

Displays the local date and time

date

This command does not accept any options.

A.16.5. flash test

Tests message flashing

flash test

This command does not accept any options.

A.16.6. script

Parses the specified resource file and executes its commands

script --file
--file

The file to locate and execute; no default value (mandatory)

--lineNumbers

Display line numbers when executing the script; default if option present: 'true'; default if option not present: 'false'

A.16.7. system properties

Shows the shell's properties

system properties

This command does not accept any options.

A.16.8. version

Displays shell version

version
--[default]

Special version flags; no default value

A.17. Jms Commands

Jms Commands are contained in org.springframework.roo.addon.jms.JmsCommands.

A.17.1. field jms template

Insert a JmsOperations field into an existing type

field jms template
--fieldName

The name of the field to add; default: 'jmsOperations'

--class

The name of the class to receive this field; default if option not present: '*'

--async

Indicates if the injected method should be executed asynchronously; default if option present: 'true'; default if option not present: 'false'

A.17.2. jms listener class

Create an asynchronous JMS consumer

jms listener class --class
--class

The name of the class to create; no default value (mandatory)

--destinationName

The name of the destination; default: 'myDestination'

--destinationType

The type of the destination; default: 'QUEUE'

A.17.3. jms setup

Install a JMS provider into your project

jms setup --provider
--provider

The persistence provider to support; no default value (mandatory)

--destinationName

The name of the destination; default: 'myDestination'

--destinationType

The type of the destination; default: 'QUEUE'

A.18. Jpa Commands

Jpa Commands are contained in org.springframework.roo.addon.jpa.JpaCommands.

A.18.1. database properties list

Shows database configuration details

database properties list

This command does not accept any options.

A.18.2. database properties remove

Removes a particular database property

database properties remove --key
--key

The property key that should be removed; no default value (mandatory)

A.18.3. database properties set

Changes a particular database property

database properties set --key --value
--key

The property key that should be changed; no default value (mandatory)

--value

The new vale for this property key; no default value (mandatory)

A.18.4. embeddable

Creates a new Java class source file with the JPA @Embeddable annotation in SRC_MAIN_JAVA

embeddable --class
--class

The name of the class to create; no default value (mandatory)

--serializable

Whether the generated class should implement java.io.Serializable; default if option present: 'true'; default if option not present: 'false'

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

A.18.5. entity jpa

Creates a new JPA persistent entity in SRC_MAIN_JAVA

entity jpa --class
--class

Name of the entity to create; no default value (mandatory)

--extends

The superclass (defaults to java.lang.Object); default if option not present: 'java.lang.Object'

--implements

The interface to implement; no default value

--abstract

Whether the generated class should be marked as abstract; default if option present: 'true'; default if option not present: 'false'

--testAutomatically

Create automatic integration tests for this entity; default if option present: 'true'; default if option not present: 'false'

--table

The JPA table name to use for this entity; no default value

--schema

The JPA table schema name to use for this entity; no default value

--catalog

The JPA table catalog name to use for this entity; no default value

--identifierField

The JPA identifier field name to use for this entity; no default value

--identifierColumn

The JPA identifier field column to use for this entity; no default value

--identifierType

The data type that will be used for the JPA identifier field (defaults to java.lang.Long); default: 'java.lang.Long'

--versionField

The JPA version field name to use for this entity; no default value

--versionColumn

The JPA version field column to use for this entity; no default value

--versionType

The data type that will be used for the JPA version field (defaults to java.lang.Integer); default if option not present: 'java.lang.Integer'

--inheritanceType

The JPA @Inheritance value (apply to base class); no default value

--mappedSuperclass

Apply @MappedSuperclass for this entity; default if option present: 'true'; default if option not present: 'false'

--equals

Whether the generated class should implement equals and hashCode methods; default if option present: 'true'; default if option not present: 'false'

--serializable

Whether the generated class should implement java.io.Serializable; default if option present: 'true'; default if option not present: 'false'

--persistenceUnit

The persistence unit name to be used in the persistence.xml file; no default value

--transactionManager

The transaction manager name; no default value

--permitReservedWords

Indicates whether reserved words are ignored by Roo; default if option present: 'true'; default if option not present: 'false'

--entityName

The name used to refer to the entity in queries; no default value

--sequenceName

The name of the sequence for incrementing sequence-driven primary keys; no default value

--activeRecord

Generate CRUD active record methods for this entity; default: 'true'

A.18.6. jpa setup

Install or updates a JPA persistence provider in your project

jpa setup --provider --database
--provider

The persistence provider to support; no default value (mandatory)

--database

The database to support; no default value (mandatory)

--applicationId

The Google App Engine application identifier to use; default if option not present: 'the project's name'

--jndiDataSource

The JNDI datasource to use; no default value

--hostName

The host name to use; no default value

--databaseName

The database name to use; no default value

--userName

The username to use; no default value

--password

The password to use; no default value

--transactionManager

The transaction manager name; no default value

--persistenceUnit

The persistence unit name to be used in the persistence.xml file; no default value

A.18.7. persistence setup

Install or updates a JPA persistence provider in your project - deprecated, use 'jpa setup' instead

persistence setup --provider --database
--provider

The persistence provider to support; no default value (mandatory)

--database

The database to support; no default value (mandatory)

--applicationId

The Google App Engine application identifier to use; default if option not present: 'the project's name'

--jndiDataSource

The JNDI datasource to use; no default value

--hostName

The host name to use; no default value

--databaseName

The database name to use; no default value

--userName

The username to use; no default value

--password

The password to use; no default value

--transactionManager

The transaction manager name; no default value

--persistenceUnit

The persistence unit name to be used in the persistence.xml file; no default value

A.19. Jsf Commands

Jsf Commands are contained in org.springframework.roo.addon.jsf.JsfCommands.

A.19.1. web jsf all

Create JSF managed beans for all entities

web jsf all --package
--package

The package in which new JSF managed beans will be placed; no default value (mandatory)

A.19.2. web jsf media

Add a cross-browser generic player to embed multimedia content

web jsf media --url
--url

The url of the media source; no default value (mandatory)

--player

The name of the media player; no default value

A.19.3. web jsf scaffold

Create JSF managed bean for an entity

web jsf scaffold --class
--class

The path and name of the JSF managed bean to be created; no default value (mandatory)

--entity

The entity which this JSF managed bean class will create and modify as required; default if option not present: '*'

--beanName

The name of the managed bean to use in the 'name' attribute of the @ManagedBean annotation; no default value

--includeOnMenu

Include this entity on the generated JSF menu; default: 'true'

A.19.4. web jsf setup

Set up JSF environment

web jsf setup
--implementation

The JSF implementation to use; no default value

--library

The JSF component library to use; no default value

--theme

The name of the theme; no default value

A.20. Json Commands

Json Commands are contained in org.springframework.roo.addon.json.JsonCommands.

A.20.1. json add

Adds @RooJson annotation to target type

json add
--class

The java type to apply this annotation to; default if option not present: '*'

--rootName

The root name which should be used to wrap the JSON document; no default value

--deepSerialize

Indication if deep serialization should be enabled.; default if option present: 'true'; default if option not present: 'false'

--iso8601Dates

Indication if dates should be formatted according to ISO 8601; default if option present: 'true'; default if option not present: 'false'

A.20.2. json all

Adds @RooJson annotation to all types annotated with @RooJavaBean

json all
--deepSerialize

Indication if deep serialization should be enabled; default if option present: 'true'; default if option not present: 'false'

--iso8601Dates

Indication if dates should be formatted according to ISO 8601; default if option present: 'true'; default if option not present: 'false'

A.21. Jsp Commands

Jsp Commands are contained in org.springframework.roo.addon.web.mvc.jsp.JspCommands.

A.21.1. controller class

Create a new manual Controller (ie where you write the methods) - deprecated, use 'web mvc controller' instead

controller class --class
--class

The path and name of the controller object to be created; no default value (mandatory)

--preferredMapping

Indicates a specific request mapping path for this controller (eg /foo/); no default value

A.21.2. web mvc controller

Create a new manual Controller (ie where you write the methods)

web mvc controller --class
--class

The path and name of the controller object to be created; no default value (mandatory)

--preferredMapping

Indicates a specific request mapping path for this controller (eg /foo/); no default value

A.21.3. web mvc install language

Install new internationalization bundle for MVC scaffolded UI.

web mvc install language --code
--code

The language code for the desired bundle; no default value (mandatory)

A.21.4. web mvc install view

Create a new static view.

web mvc install view --path --viewName --title
--path

The path the static view to create in (required, ie '/foo/blah'); no default value (mandatory)

--viewName

The view name the mapping this view should adopt (required, ie 'index'); no default value (mandatory)

--title

The title of the view; no default value (mandatory)

A.21.5. web mvc language

Install new internationalization bundle for MVC scaffolded UI.

web mvc language --code
--code

The language code for the desired bundle; no default value (mandatory)

A.21.6. web mvc setup

Setup a basic project structure for a Spring MVC / JSP application

web mvc setup

This command does not accept any options.

A.21.7. web mvc update tags

Replace an existing application tagx library with the latest version (use --backup option to backup your application first)

web mvc update tags
--backup

Backup your application before replacing your existing tag library; default if option present: 'true'; default if option not present: 'false'

A.21.8. web mvc view

Create a new static view.

web mvc view --path --viewName --title
--path

The path the static view to create in (required, ie '/foo/blah'); no default value (mandatory)

--viewName

The view name the mapping this view should adopt (required, ie 'index'); no default value (mandatory)

--title

The title of the view; no default value (mandatory)

A.22. Logging Commands

Logging Commands are contained in org.springframework.roo.addon.logging.LoggingCommands.

A.22.1. logging setup

Configure logging in your project

logging setup --level
--level

The log level to configure; no default value (mandatory)

--package

The package to append the logging level to (all by default); no default value

A.23. Mail Commands

Mail Commands are contained in org.springframework.roo.addon.email.MailCommands.

A.23.1. email sender setup

Install a Spring JavaMailSender in your project

email sender setup --hostServer
--hostServer

The host server; no default value (mandatory)

--protocol

The protocol used by mail server; no default value

--port

The port used by mail server; no default value

--encoding

The encoding used for mail; no default value

--username

The mail account username; no default value

--password

The mail account password; no default value

A.23.2. email template setup

Configures a template for a SimpleMailMessage

email template setup
--from

The 'from' email (optional); no default value

--subject

The message subject (obtional); no default value

A.23.3. field email template

Inserts a MailTemplate field into an existing type

field email template
--fieldName

The name of the field to add; default: 'mailTemplate'

--class

The name of the class to receive this field; default if option not present: '*'

--async

Indicates if the injected method should be executed asynchronously; default if option present: 'true'; default if option not present: 'false'

A.24. Maven Commands

Maven Commands are contained in org.springframework.roo.project.MavenCommands.

A.24.1. dependency add

Adds a new dependency to the Maven project object model (POM)

dependency add --groupId --artifactId --version
--groupId

The group ID of the dependency; no default value (mandatory)

--artifactId

The artifact ID of the dependency; no default value (mandatory)

--version

The version of the dependency; no default value (mandatory)

--classifier

The classifier of the dependency; no default value

--scope

The scope of the dependency; no default value

A.24.2. dependency remove

Removes an existing dependency from the Maven project object model (POM)

dependency remove --groupId --artifactId --version
--groupId

The group ID of the dependency; no default value (mandatory)

--artifactId

The artifact ID of the dependency; no default value (mandatory)

--version

The version of the dependency; no default value (mandatory)

--classifier

The classifier of the dependency; no default value

A.24.3. maven repository add

Adds a new repository to the Maven project object model (POM)

maven repository add --id --url
--id

The ID of the repository; no default value (mandatory)

--name

The name of the repository; no default value

--url

The URL of the repository; no default value (mandatory)

A.24.4. maven repository remove

Removes an existing repository from the Maven project object model (POM)

maven repository remove --id --url
--id

The ID of the repository; no default value (mandatory)

--url

The URL of the repository; no default value (mandatory)

A.24.5. module create

Creates a new Maven module

module create --moduleName --topLevelPackage
--moduleName

The name of the module; no default value (mandatory)

--topLevelPackage

The uppermost package name (this becomes the <groupId> in Maven and also the '~' value when using Roo's shell); no default value (mandatory)

--java

Forces a particular major version of Java to be used (will be auto-detected if unspecified; specify 6 or 7 only); no default value

--parent

The Maven coordinates of the parent POM, in the form "groupId:artifactId:version"; no default value

--packaging

The Maven packaging of this module; default if option not present: 'jar'

--artifactId

The artifact ID of this module (defaults to moduleName if not specified); no default value

A.24.6. module focus

Changes focus to a different project module

module focus --moduleName
--moduleName

The module to focus on; no default value (mandatory)

A.24.7. perform assembly

Executes the assembly goal via Maven

perform assembly

This command does not accept any options.

A.24.8. perform clean

Executes a full clean (including Eclipse files) via Maven

perform clean

This command does not accept any options.

A.24.9. perform command

Executes a user-specified Maven command

perform command --mavenCommand
--mavenCommand

User-specified Maven command (eg test:test); no default value (mandatory)

A.24.10. perform eclipse

Sets up Eclipse configuration via Maven (only necessary if you have not installed the m2eclipse plugin in Eclipse)

perform eclipse

This command does not accept any options.

A.24.11. perform package

Packages the application using Maven, but does not execute any tests

perform package

This command does not accept any options.

A.24.12. perform tests

Executes the tests via Maven

perform tests

This command does not accept any options.

A.24.13. project

Creates a new Maven project

project --topLevelPackage
--topLevelPackage

The uppermost package name (this becomes the <groupId> in Maven and also the '~' value when using Roo's shell); no default value (mandatory)

--projectName

The name of the project (last segment of package name used as default); no default value

--java

Forces a particular major version of Java to be used (will be auto-detected if unspecified; specify 5 or 6 or 7 only); no default value

--parent

The Maven coordinates of the parent POM, in the form "groupId:artifactId:version"; no default value

--packaging

The Maven packaging of this project; default if option not present: 'jar'

A.25. Metadata Commands

Metadata Commands are contained in org.springframework.roo.classpath.MetadataCommands.

A.25.1. metadata cache

Shows detailed metadata for the indicated type

metadata cache --maximumCapacity
--maximumCapacity

The maximum number of metadata items to cache; no default value (mandatory)

A.25.2. metadata for id

Shows detailed information about the metadata item

metadata for id --metadataId
--metadataId

The metadata ID (should start with MID:); no default value (mandatory)

A.25.3. metadata for module

Shows the ProjectMetadata for the indicated project module

metadata for module
--module

The module for which to retrieve the metadata (defaults to the focused module); no default value

A.25.4. metadata for type

Shows detailed metadata for the indicated type

metadata for type --type
--type

The Java type for which to display metadata; no default value (mandatory)

A.25.5. metadata status

Shows metadata statistics

metadata status

This command does not accept any options.

A.25.6. metadata trace

Traces metadata event delivery notifications

metadata trace --level
--level

The verbosity of notifications (0=none, 1=some, 2=all); no default value (mandatory)

A.26. Mongo Commands

Mongo Commands are contained in org.springframework.roo.addon.layers.repository.mongo.MongoCommands.

A.26.1. entity mongo

Creates a domain entity which can be backed by a MongoDB repository

entity mongo --class
--class

Implementation class for the specified interface; no default value (mandatory)

--identifierType

The ID type to be used for this domain type (defaults to BigInteger); no default value

--testAutomatically

Create automatic integration tests for this entity; default if option present: 'true'; default if option not present: 'false'

A.26.2. mongo setup

Configures the project for MongoDB peristence.

mongo setup
--username

Username for accessing the database (defaults to ''); no default value

--password

Password for accessing the database (defaults to ''); no default value

--databaseName

Name of the database (defaults to project name); no default value

--port

Port for the database (defaults to '27017'); no default value

--host

Host for the database (defaults to '127.0.0.1'); no default value

--cloudFoundry

Deploy to CloudFoundry (defaults to 'false'); default if option present: 'true'; default if option not present: 'false'

A.26.3. repository mongo

Adds @RooMongoRepository annotation to target type

repository mongo --interface
--interface

The java interface to apply this annotation to; no default value (mandatory)

--entity

The domain entity this repository should expose; default if option not present: '*'

A.27. Os Commands

Os Commands are contained in org.springframework.roo.addon.oscommands.OsCommands.

A.27.1. !

Allows execution of operating system (OS) commands.

!
--command

The command to execute; default: ''

A.28. Pgp Commands

Pgp Commands are contained in org.springframework.roo.felix.pgp.PgpCommands.

A.28.1. pgp automatic trust

Indicates to automatically trust all keys encountered until the command is invoked again

pgp automatic trust

This command does not accept any options.

A.28.2. pgp key view

Downloads a remote key and displays it to the user (does not change any trusts)

pgp key view --keyId
--keyId

The key ID to view (eg 00B5050F or 0x00B5050F); no default value (mandatory)

A.28.3. pgp list trusted keys

Lists the keys you currently trust and have not been revoked at the time last downloaded from a public key server

pgp list trusted keys

This command does not accept any options.

A.28.4. pgp refresh all

Refreshes all keys from public key servers

pgp refresh all

This command does not accept any options.

A.28.5. pgp status

Displays the status of the PGP environment

pgp status

This command does not accept any options.

A.28.6. pgp trust

Grants trust to a particular key ID

pgp trust --keyId
--keyId

The key ID to trust (eg 00B5050F or 0x00B5050F); no default value (mandatory)

A.28.7. pgp untrust

Revokes your trust for a particular key ID

pgp untrust --keyId
--keyId

The key ID to remove trust from (eg 00B5050F or 0x00B5050F); no default value (mandatory)

A.29. Process Manager Commands

Process Manager Commands are contained in org.springframework.roo.process.manager.ProcessManagerCommands.

A.29.1. development mode

Switches the system into development mode (greater diagnostic information)

development mode
--enabled

Activates development mode; default: 'true'

A.29.2. poll now

Perform a manual file system poll

poll now

This command does not accept any options.

A.29.3. poll speed

Changes the file system polling speed

poll speed --ms
--ms

The number of milliseconds between each poll; no default value (mandatory)

A.29.4. poll status

Display file system polling information

poll status

This command does not accept any options.

A.30. Process Manager Diagnostics Listener

Process Manager Diagnostics Listener are contained in org.springframework.roo.process.manager.internal.ProcessManagerDiagnosticsListener.

A.30.1. process manager debug

Indicates if process manager debugging is desired

process manager debug
--enabled

Activates debug mode; default: 'true'

A.31. Prop File Commands

Prop File Commands are contained in org.springframework.roo.addon.propfiles.PropFileCommands.

A.31.1. properties list

Shows the details of a particular properties file

properties list --name --path
--name

Property file name (including .properties suffix); no default value (mandatory)

--path

Source path to property file; no default value (mandatory)

A.31.2. properties remove

Removes a particular properties file property

properties remove --name --path --key
--name

Property file name (including .properties suffix); no default value (mandatory)

--path

Source path to property file; no default value (mandatory)

--key

The property key that should be removed; no default value (mandatory)

A.31.3. properties set

Changes a particular properties file property

properties set --name --path --key --value
--name

Property file name (including .properties suffix); no default value (mandatory)

--path

Source path to property file; no default value (mandatory)

--key

The property key that should be changed; no default value (mandatory)

--value

The new vale for this property key; no default value (mandatory)

A.32. Proxy Configuration Commands

Proxy Configuration Commands are contained in org.springframework.roo.url.stream.jdk.ProxyConfigurationCommands.

A.32.1. proxy configuration

Shows the proxy server configuration

proxy configuration

This command does not accept any options.

A.33. Repository Jpa Commands

Repository Jpa Commands are contained in org.springframework.roo.addon.layers.repository.jpa.RepositoryJpaCommands.

A.33.1. repository jpa

Adds @RooJpaRepository annotation to target type

repository jpa --interface
--interface

The java interface to apply this annotation to; no default value (mandatory)

--entity

The domain entity this repository should expose; default if option not present: '*'

A.34. Security Commands

Security Commands are contained in org.springframework.roo.addon.security.SecurityCommands.

A.34.1. permissionEvaluator

Create a permission evaluator

permissionEvaluator --package
--package

The package to add the permission evaluator to; no default value (mandatory)

A.34.2. security setup

Install Spring Security into your project

security setup

This command does not accept any options.

A.35. Selenium Commands

Selenium Commands are contained in org.springframework.roo.addon.web.selenium.SeleniumCommands.

A.35.1. selenium test

Creates a new Selenium test for a particular controller

selenium test --controller
--controller

Controller to create a Selenium test for; no default value (mandatory)

--name

Name of the test; no default value

--serverUrl

URL of the server where the web application is available, including protocol, port and hostname; default: 'http://localhost:8080/'

A.36. Service Commands

Service Commands are contained in org.springframework.roo.addon.layers.service.ServiceCommands.

A.36.1. service all

Adds @RooService annotation to all entities

service all --interfacePackage
--interfacePackage

The java interface package; no default value (mandatory)

--classPackage

The java package of the implementation classes for the interfaces; no default value

--useXmlConfiguration

When true, Spring Roo will configure services using XML. This is the default behavior for services using GAE; no default value

A.36.2. service secure all

Adds @RooService annotation to all entities with options for authentication, authorization, and a permission evaluator

service secure all --interfacePackage
--interfacePackage

The java interface package; no default value (mandatory)

--classPackage

The java package of the implementation classes for the interfaces; no default value

--requireAuthentication

Whether or not users must be authenticated to use the service; default if option present: 'true'; default if option not present: 'false'

--authorizedRole

The role authorized the use the methods in the service (additional roles can be added after creation); no default value

--usePermissionEvaluator

Whether or not to use a PermissionEvaluator; default if option present: 'true'; default if option not present: 'false'

--useXmlConfiguration

When true, Spring Roo will configure services using XML.; no default value

A.36.3. service secure type

Adds @RooService annotation to target type with options for authentication, authorization, and a permission evaluator

service secure type --interface
--interface

The java interface to apply this annotation to; no default value (mandatory)

--class

Implementation class for the specified interface; no default value

--entity

The domain entity this service should expose; default if option not present: '*'

--requireAuthentication

Whether or not users must be authenticated to use the service; default if option present: 'ture'; default if option not present: 'false'

--authorizedRoles

The role authorized the use the methods in the service; no default value

--usePermissionEvaluator

Whether or not to use a PermissionEvaluator; default if option present: 'true'; default if option not present: 'false'

--useXmlConfiguration

When true, Spring Roo will configure services using XML.; no default value

A.36.4. service type

Adds @RooService annotation to target type

service type --interface
--interface

The java interface to apply this annotation to; no default value (mandatory)

--class

Implementation class for the specified interface; no default value

--entity

The domain entity this service should expose; default if option not present: '*'

--useXmlConfiguration

When true, Spring Roo will configure services using XML.; no default value

A.37. Simple Parser Component

Simple Parser Component are contained in org.springframework.roo.shell.osgi.SimpleParserComponent.

A.37.1. help

Shows system help

help
--command

Command name to provide help for; no default value

A.37.2. reference guide

Writes the reference guide XML fragments (in DocBook format) into the current working directory

reference guide

This command does not accept any options.

A.38. Solr Commands

Solr Commands are contained in org.springframework.roo.addon.solr.SolrCommands.

A.38.1. solr add

Make target type searchable

solr add
--class

The type to be made searchable; default if option not present: '*'

A.38.2. solr all

Make all eligible project types searchable

solr all

This command does not accept any options.

A.38.3. solr setup

Install support for Solr search integration

solr setup
--searchServerUrl

The URL of the Solr search server; default: 'http://localhost:8983/solr'

A.39. Tailor Commands

Tailor Commands are contained in org.springframework.roo.addon.tailor.TailorCommands.

A.39.1. tailor activate

Activate a tailor configuration.

tailor activate --name
--name

The name of the tailor configuration; no default value (mandatory)

A.39.2. tailor deactivate

Deactivate the tailor.

tailor deactivate

This command does not accept any options.

A.39.3. tailor list

List available tailor configurations.

tailor list

This command does not accept any options.

A.40. Uaa Commands

Uaa Commands are contained in org.springframework.roo.uaa.UaaCommands.

A.40.1. download accept terms of use

Accepts the Spring User Agent Analysis (UAA) Terms of Use

download accept terms of use

This command does not accept any options.

A.40.2. download privacy level

Changes the Spring User Agent Analysis (UAA) privacy level

download privacy level --privacyLevel
--privacyLevel

The new UAA privacy level to use; no default value (mandatory)

A.40.3. download reject terms of use

Rejects the Spring User Agent Analysis (UAA) Terms of Use

download reject terms of use

This command does not accept any options.

A.40.4. download status

Provides a summary of the Spring User Agent Analysis (UAA) status and commands

download status

This command does not accept any options.

A.40.5. download view

Displays the Spring User Agent Analysis (UAA) header content in plain text

download view
--file

The file to save the UAA JSON content to; no default value

A.41. Web Finder Commands

Web Finder Commands are contained in org.springframework.roo.addon.web.mvc.controller.finder.WebFinderCommands.

A.41.1. web mvc finder add

Adds @RooWebFinder annotation to MVC controller type

web mvc finder add --formBackingType
--formBackingType

The finder-enabled type; no default value (mandatory)

--class

The controller java type to apply this annotation to; default if option not present: '*'

A.41.2. web mvc finder all

Adds @RooWebFinder annotation to existing MVC controllers

web mvc finder all

This command does not accept any options.

A.42. Web Flow Commands

Web Flow Commands are contained in org.springframework.roo.addon.web.flow.WebFlowCommands.

A.42.1. web flow

Install Spring Web Flow configuration artifacts into your project

web flow
--flowName

The name for your web flow; no default value

A.43. Web Json Commands

Web Json Commands are contained in org.springframework.roo.addon.web.mvc.controller.json.WebJsonCommands.

A.43.1. web mvc json add

Adds @RooJson annotation to target type

web mvc json add --jsonObject
--jsonObject

The JSON-enabled object which backs this Spring MVC controller.; no default value (mandatory)

--class

The java type to apply this annotation to; default if option not present: '*'

A.43.2. web mvc json all

Adds or creates MVC controllers annotated with @RooWebJson annotation

web mvc json all
--package

The package in which new controllers will be placed; no default value

A.43.3. web mvc json setup

Set up Spring MVC to support JSON

web mvc json setup

This command does not accept any options.