Java Doc for HandleListener.java in  » GIS » udig-1.1 » net » refractions » udig » catalog » util » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » GIS » udig 1.1 » net.refractions.udig.catalog.util 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   net.refractions.udig.catalog.util.HandleListener

HandleListener
abstract public class HandleListener implements IResolveChangeListener(Code)
Easy example that listens to a specific IResolve.

Will do its best to reduce the IResolveChangeEvent to:

  • start() - called after create with valid handle
  • stop() - called before remove while handle is still valid
  • dispose() - called after remove while handle is invalid
  • refresh() - called when handle has changed
  • replace() - called when handle is replaced
  • reset() - called when handle is replaced, and replacement is unknown

Note 1: The IResolveDelta does not always include information about *your* handle. If your parent is being replaced - your direct replacement may not be available until you ask for it.

Translation repalce with a null newResolve = reset. This indicates you need to find your handle again from first principles.

Note 2: HandleListener only holds onto a IResolve with a weak reference. Although this protects you a little bit, you still need to remove zombie listeners from the catalog (they cannot do it themselves).

However when the weak reference is cleaned up, we will notice and call dispose for you.


author:
   jgarnett
since:
   0.9.0



Constructor Summary
public  HandleListener(IResolve handle)
    

Method Summary
final public  voidchanged(IResolveChangeEvent event)
    
abstract public  voiddispose()
    
public  IResolvegetHandle()
     Resolve the handle - will call dispose if handle has passed out of scope.
abstract public  voidrefresh(IResolve handle)
    
abstract public  voidreplace(IResolve handle, IResolve newHandle)
     Handle is being replaced with newHandle.
abstract public  voidreset(IResolve handle, IResolveChangeEvent event)
     This is a replace where the replacement is unknown.

This occurs when:

  • an IResolveChangeDelta indicates your is replaced
  • an IResolveChangeDelta indicates you replaced

In both cases you have two options:

  • Easy: find your replacement handle from first principles (ie look it up in the catalog)
  • Harder: as an optimization you can try and look through the event information and locate the delta for your parent.
public  voidsetHandle(IResolve newHandle)
     Can be called during a repalce, or reset to switch this listener over to the new handle.
abstract public  voidstart(IResolve handle)
    
abstract public  voidstop(IResolve handle)
    


Constructor Detail
HandleListener
public HandleListener(IResolve handle)(Code)




Method Detail
changed
final public void changed(IResolveChangeEvent event)(Code)
Actual listener implemtnation



dispose
abstract public void dispose()(Code)
Called after remove while handle is invalid



getHandle
public IResolve getHandle()(Code)
Resolve the handle - will call dispose if handle has passed out of scope.



refresh
abstract public void refresh(IResolve handle)(Code)
Called when handle has changed



replace
abstract public void replace(IResolve handle, IResolve newHandle)(Code)
Handle is being replaced with newHandle.

Note: This method is called post change, the newHandle already exists in the catalog.

You have two options:

  • use setHandle( newHandle ) during your implemenation to switch over to the newHandle
  • remove this listener and set up a new one watching newHandle




reset
abstract public void reset(IResolve handle, IResolveChangeEvent event)(Code)
This is a replace where the replacement is unknown.

This occurs when:

  • an IResolveChangeDelta indicates your is replaced
  • an IResolveChangeDelta indicates you replaced

In both cases you have two options:

  • Easy: find your replacement handle from first principles (ie look it up in the catalog)
  • Harder: as an optimization you can try and look through the event information and locate the delta for your parent. This delta may indicate your new parent, allowing you to locate your "new" handle in a more timely fashion.


Parameters:
  handle -



setHandle
public void setHandle(IResolve newHandle)(Code)
Can be called during a repalce, or reset to switch this listener over to the new handle.
Parameters:
  handle -



start
abstract public void start(IResolve handle)(Code)
Called after create with valid handle



stop
abstract public void stop(IResolve handle)(Code)
Called before remove while handle is still valid



Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.