If you have a RepositoryItem which has a collection of other RepositoryItems as a property, editing things on them via a single form and RepositoryFormHandler can pose some difficulties.

For instance, you have an Item called Garage, and it has a List of Car RepositoryItems as a property named cars. If you are using a different type of collection, some of the following will need to be adjusted accordingly, but the overall approach is the same. A Car Item has a name and an option picture as properties. If you have a form to display and allow for editing of a Garage, including all of its cars, which is handled by a sub-class of a RepositoryFormHandler, you can edit values on both the Garage, as well as the Cars within cars, without much difficulty.

What gets tricky is if you need to access form submission values for properties on the Cars. For instance if you wanted to allow a user to delete a car by simply blanking it’s name, or if you wanted to automatically assign a picture based on the make and model in the name field. You can’t just access the submitted but un-updated values (say from within the preUpdateItem method) using simple nested getValueProperties. Here is what you can do:

First you need to get the List of cars. This is actually an instance of a RepositoryFormList.

RepositoryFormList carsFormList = (RepositoryFormList) getValueProperty("cars");

This is a subclass of ArrayList, and can be iterated through to get at each car’s incoming values. Remember we aren’t dealing with the actual RepositoryItems, that would be easy, this is what to do in order to grab the form submitted values destined for properties on these sub-Items in the preUpdateItem life-cycle phase. The contents of this ArrayList are RepositoryFormHashtables.

Iterator iter = carsFormList.iterator();
while (iter.hasNext()) {
RepositoryFormHashtable rfh = (RepositoryFormHashtable) iter.next();

The incoming property values are in this Hashtable, keyed by the property’s CAPITALIZED name:

String incomingName = (String) rfh.get("NAME");

Now that you have the name you can see if it’s blank and then delete the related car Item (hint: the repositoryId of the car Item this set of properties is destined for is in the Hashtable with the key of “REPOSITORYID”), or parse it and search for a normalized version, or find a related image automatically, or whatever else you wanted to do with it prior to the actual handleUpdate phase.

You can also get the RepositoryItem by calling:
RepositoryItem rfhitem = rfh.getRepositoryItem();

To be on the safe side your best bet is validate that and do something like this:

final RepositoryItem rfhitem = rfh.getRepositoryItem();
MutableRepositoryItem carItem = null;
if (rfhitem instanceof MutableRepositoryItem) {
carItem = (MutableRepositoryItem) rfhitem;
} else {
if (!(rfh.isEmpty() || ((rfh.size() == 1) && (rfh.get("REPOSITORYID") != null)))) {
try {
carItem = this.getRepository().getItemForUpdate(rfhitem.getRepositoryId(),
} catch (final RepositoryException e) {
if (isLoggingError()) {
"GarageFormHandler.handleUpdate: repository error while accessing an car.",

Then you can access the existing car Item in order to delete it, or compare values to the incoming values, etc…