Package it.tidalwave.role.ui

Interface PresentationModel

All Superinterfaces:

As

public interface PresentationModel
extends As

TODO: As the NetBeans Node, it should allow children, have event listeners for children added/removed/changed. This class so becomes the true M in MVC.

Author:

Fabrizio Giudici

Stereotype:

Role

Nested Class Summary

Nested classes/interfaces inherited from interface it.tidalwave.util.As

As.Type<T>

Field Summary

Fields

Modifier and Type	Field	Description
static final As.Type<SimpleComposite<PresentationModel>>	_SimpleCompositeOfPresentationModel_
static final String	CALLBACK_DISPOSE	This is an undocumented feature.
static final Class<PresentationModel>	PresentationModel
static final String	PROPERTY_CHILDREN

Method Summary

Modifier and Type	Method	Description
void	addPropertyChangeListener(PropertyChangeListener listener)	Adds a PropertyChangeListener.
void	addPropertyChangeListener(String propertyName, PropertyChangeListener listener)	Adds a PropertyChangeListener for the given property.
void	dispose()	Disposes this object.
static PresentationModel	empty()	Returns an empty instance (no roles, with the exception of a dummy Displayable).
PropertyChangeListener[]	getPropertyChangeListeners()	Returns all the bound PropertyChangeListeners.
PropertyChangeListener[]	getPropertyChangeListeners(String propertyName)	Returns the bound PropertyChangeListeners for the given property.
boolean	hasListeners(String propertyName)	Checks whether the given property has been bound to listeners.
static PresentationModel	of(Object owner)	Creates an instance given an owner and no roles.
static PresentationModel	of(Object owner, Object role)	Creates an instance given an owner and a single role.
static PresentationModel	of(Object owner, Collection<Object> roles)	Creates an instance given an owner and multiple roles.
static PresentationModel	ofMaybePresentable(As owner)	Creates an instance from an owner which might have the Presentable role.
static PresentationModel	ofMaybePresentable(As owner, Collection<Object> roles)	Creates an instance from an owner which might have the Presentable role.
void	removePropertyChangeListener(PropertyChangeListener listener)	Removes a PropertyChangeListener.
void	removePropertyChangeListener(String propertyName, PropertyChangeListener listener)	Removes a PropertyChangeListener for the given property.

Methods inherited from interface it.tidalwave.util.As

as, as, asMany, asMany, maybeAs, maybeAs

Field Details

PresentationModel

static final Class<PresentationModel> PresentationModel

_SimpleCompositeOfPresentationModel_

static final As.Type<SimpleComposite<PresentationModel>> _SimpleCompositeOfPresentationModel_

PROPERTY_CHILDREN

static final String PROPERTY_CHILDREN

See Also:

• Constant Field Values

CALLBACK_DISPOSE

static final String CALLBACK_DISPOSE

This is an undocumented feature. If you add a NamedCallback with this name as a role in this object, it will be called back when dispose() is called.

See Also:

• Constant Field Values

Method Details

dispose

void dispose()

Disposes this object.

addPropertyChangeListener

void addPropertyChangeListener(@Nonnull
 PropertyChangeListener listener)

Adds a PropertyChangeListener.

Parameters:

listener - the listener

addPropertyChangeListener

void addPropertyChangeListener(@Nonnull
 String propertyName,
 @Nonnull
 PropertyChangeListener listener)

Adds a PropertyChangeListener for the given property.

Parameters:

propertyName - the name of the property

listener - the listener

removePropertyChangeListener

void removePropertyChangeListener(@Nonnull
 PropertyChangeListener listener)

Removes a PropertyChangeListener.

Parameters:

listener - the listener

removePropertyChangeListener

void removePropertyChangeListener(@Nonnull
 String propertyName,
 @Nonnull
 PropertyChangeListener listener)

Removes a PropertyChangeListener for the given property.

Parameters:

propertyName - the name of the property

listener - the listener

hasListeners

boolean hasListeners(@Nonnull
 String propertyName)

Checks whether the given property has been bound to listeners.

Parameters:

propertyName - the name of the property

Returns:

true if the property is bound

getPropertyChangeListeners

@Nonnull
PropertyChangeListener[] getPropertyChangeListeners()

Returns all the bound PropertyChangeListeners.

Returns:

the listeners

getPropertyChangeListeners

@Nonnull
PropertyChangeListener[] getPropertyChangeListeners(@Nonnull
 String propertyName)

Returns the bound PropertyChangeListeners for the given property.

Parameters:

propertyName - the name of the property

Returns:

the listeners

of

@Nonnull
static PresentationModel of(@Nonnull
 Object owner)

Creates an instance given an owner and no roles.

Parameters:

owner - the owner

Returns:

the new instance

Since:

3.2-ALPHA-3

of

@Nonnull
static PresentationModel of(@Nonnull
 Object owner,
 @Nonnull
 Object role)

Creates an instance given an owner and a single role.

Parameters:

owner - the owner

role - the role (or a RoleFactory)

Returns:

the new instance

Since:

3.2-ALPHA-3

of

@Nonnull
static PresentationModel of(@Nonnull
 Object owner,
 @Nonnull
 Collection<Object> roles)

Creates an instance given an owner and multiple roles.

Parameters:

owner - the owner

roles - roles or RoleFactory instances

Returns:

the new instance

Since:

3.2-ALPHA-1, 3.2-ALPHA-3 (refactored)

empty

@Nonnull
static PresentationModel empty()

Returns an empty instance (no roles, with the exception of a dummy Displayable).

Returns:

the empty instance

Since:

3.2-ALPHA-3

ofMaybePresentable

@Nonnull
static PresentationModel ofMaybePresentable(@Nonnull
 As owner,
 @Nonnull
 Collection<Object> roles)

Creates an instance from an owner which might have the Presentable role. If it is present, it is called to create the PresentationModel; otherwise a default one is created. Additional roles are added.

Parameters:

owner - the owner

roles - roles or RoleFactory instances

Returns:

the new instance

Since:

3.2-ALPHA-8

ofMaybePresentable

@Nonnull
static PresentationModel ofMaybePresentable(@Nonnull
 As owner)

Creates an instance from an owner which might have the Presentable role. If it is present, it is called to create the PresentationModel; otherwise a default one is created.

Parameters:

owner - the owner

Returns:

the new instance

Since:

3.2-ALPHA-8