Difference between revisions of "Documentation/DevGuide/ProUNO/Java/Mapping of Singletons"
From Apache OpenOffice Wiki
< Documentation | DevGuide
OOoWikiBot (Talk | contribs) m (Robot: Changing Category:Documentation/Developers Guide/Professional UNO) |
OOoWikiBot (Talk | contribs) m (FINAL VERSION FOR L10N) |
||
| (One intermediate revision by one other user not shown) | |||
| Line 7: | Line 7: | ||
|NextPage=Documentation/DevGuide/ProUNO/Java/Inexact approximation of UNO Value Semantics | |NextPage=Documentation/DevGuide/ProUNO/Java/Inexact approximation of UNO Value Semantics | ||
}} | }} | ||
| + | {{Documentation/DevGuideLanguages|Documentation/DevGuide/ProUNO/Java/{{SUBPAGENAME}}}} | ||
{{DISPLAYTITLE:Mapping of Singletons}} | {{DISPLAYTITLE:Mapping of Singletons}} | ||
A new-style singleton of the form | A new-style singleton of the form | ||
Revision as of 08:06, 13 May 2009
A new-style singleton of the form
singleton Name: XIfc;
is mapped to a public Java class with the same name. The class has a single method
public static XIfc get(com.sun.star.uno.XComponentContext context) { ... }
The semantics of such a singleton getter method in Java are as follows:
- The com.sun.star.uno.XComponentContext argument must be non-null.
- The singleton getter uses com.sun.star.uno.XComponentContext:getValueByName to obtain the singleton instance (within the "
/singletons/" name space).
- If no singleton instance could be obtained, the singleton getter fails by throwing a com.sun.star.uno.DeploymentException. The net effect is that a singleton getter either returns the requested non-null singleton instance, or throws an exception; a singleton getter will never return a null instance.
Old-style singletons are not mapped into the Java language binding.
| Content on this page is licensed under the Public Documentation License (PDL). |
