ilog.views.sdm.util

Class IlvSDMUtilitiesFactory

java.lang.Object

ilog.views.sdm.util.IlvSDMUtilitiesFactory

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

IlvBPMNSDMUtilitiesFactory

public class IlvSDMUtilitiesFactory
extends Object
implements Serializable

The class IlvSDMUtilitiesFactory is a factory that creates the various utility objects used by an IlvSDMView.

You can derive this class if you want to create modified instances of these utility objects.

Example:

Suppose you want to prevent users from connecting links to nodes of a given type. The following code sample shows how to do this using a factory that creates subclasses of IlvMakeSDMLinkInteractor and IlvSDMLinkReconnector.

 public void setFactory(IlvSDMView view)
 {
   final IlvSDMEngine engine = view.getSDMEngine();
   view.setUtilitiesFactory(new IlvSDMUtilitiesFactory(){

       // Tests if a node can be connected.
       //
       private boolean acceptNode(Object obj)
       {
          return !engine.getModel().getTag(obj).equals("not_connectable");
       }
       
       // Creates a link creation interactor that calls acceptNode.
       //
       public IlvMakeSDMLinkInteractor createMakeSDMLinkInteractor(final IlvSDMEngine engine,
                                                                   IlvManagerView paletteView)
       {
         return new IlvMakeSDMLinkInteractor(){
             protected boolean acceptOrigin(IlvPoint p, IlvGraphic g){
               if(!super.acceptOrigin(p, g)) return false;
               return acceptNode(engine.getObject(g));
             }
             protected boolean acceptDestination(IlvPoint p, IlvGraphic g){
               if(!super.acceptOrigin(p, g)) return false;
               return acceptNode(engine.getObject(g));
             }
             protected void highlight(IlvGraphic g)
             {
               if(acceptNode(engine.getObject(g))){
                 super.highlight(g);
               }
             }
           };
       }
       
       // Creates a link reconnector that calls acceptNode.
       //
       public IlvSDMLinkReconnector createLinkReconnector(IlvSDMEngine engine,
                                                          IlvManagerView view)
       {
         return new IlvSDMLinkReconnector(engine, view){
             protected boolean acceptOrigin(Object link, Object obj){
               return acceptNode(obj);
             }
             protected boolean acceptDestination(Object link, Object obj){
               return acceptNode(obj);
             }
           };
       }
     });
 }
 

Since:

JViews 4.0

See Also:

IlvSDMView.setUtilitiesFactory(ilog.views.sdm.util.IlvSDMUtilitiesFactory), Serialized Form

Constructor Summary

Constructors

Constructor and Description
IlvSDMUtilitiesFactory() Creates a new IlvSDMUtilitiesFactory.

Method Summary

Modifier and Type	Method and Description
IlvSDMDragSource	createDragSource(IlvSDMEngine engine, IlvManagerView view) Returns a new instance of IlvSDMDragSource.
IlvSDMDropTarget	createDropTarget(IlvSDMEngine engine, IlvManagerView view) Returns a new instance of IlvSDMDropTarget.
IlvSDMLinkReconnector	createLinkReconnector(IlvSDMEngine engine, IlvManagerView view) Returns a new instance of IlvSDMLinkReconnector.
IlvMakeSDMLinkInteractor	createMakeSDMLinkInteractor(IlvSDMEngine engine, IlvManagerView targetView) Returns a new instance of IlvMakeSDMLinkInteractor.
IlvMakeSDMNodeInteractor	createMakeSDMNodeInteractor(IlvSDMEngine engine, IlvManagerView targetView) Returns a new instance of IlvMakeSDMNodeInteractor.
IlvSDMPaletteConnector	createPaletteConnector(IlvSDMEngine engine, IlvManagerView paletteView) Returns a new instance of IlvSDMPaletteConnector.

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvSDMUtilitiesFactory

public IlvSDMUtilitiesFactory()

Creates a new IlvSDMUtilitiesFactory.

Method Detail

createDragSource

public IlvSDMDragSource createDragSource(IlvSDMEngine engine,
                                         IlvManagerView view)

Returns a new instance of IlvSDMDragSource.

This method is called the first time the method IlvSDMView.setDragEnabled(boolean) is called, to create the drag source.

Parameters:

engine - The SDM engine.

view - The SDM view.

createDropTarget

public IlvSDMDropTarget createDropTarget(IlvSDMEngine engine,
                                         IlvManagerView view)

Returns a new instance of IlvSDMDropTarget.

This method is called the first time the method IlvSDMView.setDropEnabled(boolean) is called, to create the drop target.

Parameters:

engine - The SDM engine.

view - The SDM view.

createLinkReconnector

public IlvSDMLinkReconnector createLinkReconnector(IlvSDMEngine engine,
                                                   IlvManagerView view)

Returns a new instance of IlvSDMLinkReconnector.

This method is called the first time the method IlvSDMView.setLinkReconnectionEnabled(boolean) is called, to create the link reconnector.

Parameters:

engine - The SDM engine.

view - The SDM view.

createPaletteConnector

public IlvSDMPaletteConnector createPaletteConnector(IlvSDMEngine engine,
                                                     IlvManagerView paletteView)

Returns a new instance of IlvSDMPaletteConnector.

This method is called the first time the method setTargetView is called, to create the palette connector.

Parameters:

engine - The SDM engine.

paletteView - The SDM view used as a palette for the IlvSDMPaletteConnector.

createMakeSDMNodeInteractor

public IlvMakeSDMNodeInteractor createMakeSDMNodeInteractor(IlvSDMEngine engine,
                                                            IlvManagerView targetView)

Returns a new instance of IlvMakeSDMNodeInteractor.

This method is called by the method setTargetView each time the target view of a palette is changed.

Parameters:

engine - The SDM engine.

targetView - The target view used by the IlvSDMPaletteConnector.

createMakeSDMLinkInteractor

public IlvMakeSDMLinkInteractor createMakeSDMLinkInteractor(IlvSDMEngine engine,
                                                            IlvManagerView targetView)

Returns a new instance of IlvMakeSDMLinkInteractor.

This method is called by the method setTargetView each time the target view of a palette is changed.

Parameters:

engine - The SDM engine.

targetView - The target view used by the IlvSDMPaletteConnector.