JeeWiz Home  
The Model-Driven System Builder

JeeWiz Architect's Guide
 
Contents  >   14.  'Business Object' Reference
 


14.26 JarBase Object

Used on
application
Superclassjava:jar
Subclassed By
serverJar
DescriptionThis is a base for 'jar' and 'ui-jar'.

It is necessary because the base-view list needs be held by a superclass common to
  • the holder of the data-view list (i.e. the businessObject:jar)
  • and the holder of the ui-view list( i.e. the screen:ui-jar)
Contained
Lists
1
Name  referenceType
Type  java:referenceType
Inherited from  java:jar
 
2
Name  jarGlobalImports
Type  String
Inherited from  java:jar
 
3
Name  baseViewRelation
Type  baseViewRelation
GenerateAllList  true
 
4
Name  internalClass
Type  java:jwclass
Description   This list indexes classes and interfaces for the business object model.
Previous Model  java:jwclass
Indexed property  name
Inherited
properties
name from java:jar.name

description from java:interfaceMethod.description

template (base property)

text from java:interface.text

jwpattern (base property)

extraJavacProperties from java:jar.extraJavacProperties

extraJavacElements from java:jar.extraJavacElements

extraJarProperties from java:jar.extraJarProperties

createAggregateImports from java:jar.createAggregateImports

headerComment from java:referenceType.headerComment

customerHeaderComment from java:referenceType.customerHeaderComment

package from baseViewRelation.package

generateLogLevel from constraint.generateLogLevel

 14.26.1  Property 'constraintExceptionType'
 14.26.2  Property 'uid'
 14.26.3  Property 'generateSecurityRoles'
 14.26.4  Property 'convertEmptyStringsToNull'

14.26.1  Property 'constraintExceptionType'
DescriptionThe constraintExceptionType is the type of the exception which is thrown if the constraint fails.

It can be any valid class name - probably defined by a 'jwclass'. It could be, for example, a specific class of business exception which should be thrown for this constraint.

If this is not in the same package as the build module (e.g. in the EJB Jar or Ear), then the name should be qualified by the package name.

The constraintExceptionType is available on constraints, objects and assemblies, and can also be set in the top level properties build file (e.g. build.jwp).

Because this is a delegated property, the actual value used is whichever instance is encountered first, working up from the validation object. This means it is very easy to specialise the exceptions thrown in part of the specification tree (e.g. one session EJB), leaving the rest unchanged.

Failing any value at all, 'RuntimeException' is used ... but clearly this should not be used in production systems.
TypeString
Delegatestrue

14.26.2  Property 'uid'
DescriptionThe 'uid' is a Unique IDentifier for a methods in the business object model (and derivatives like J2EE).

The 'uid' uniquely identifies the method, even if the name or signature of the method changes.

This will normally be generated by the modelling tool; if not, it can be entered manually (but make sure it is unique!).
TypeString

14.26.3  Property 'generateSecurityRoles'
DescriptionIf set to "true", switches on the automatic creation of the security roles from any existing role-groups defined in the application or EjbJars. This value is available on EJBJars and Applications as well as within the role-groups.

This is a delegated property, so you do not need to set the value on this object. The value used will then be the first value encountered on the parent chain.

The default is true - security-roles are generated. This is set in the business object models system.properties. If you want to disable this for a particular object, set the value to "false".
Typeboolean
Delegatestrue

14.26.4  Property 'convertEmptyStringsToNull'
DescriptionThis delegated property when set causes empty values, on input (e.g. on screens) into optional fields, to be converted to null. This property is present on the attribute or data-view-field and their parents. This property has no effect on required values.

By default, this property is set (in the Business Object Model's system.properties).

If this value is not set, there is no way to express 'no value' on input screens.
Typeboolean
Delegatestrue
 


Copyright (c) 2001-2008 New Technology/enterprise Ltd.