Mapping of Singletons

From Apache OpenOffice Wiki
Jump to: navigation, search

A new-style singleton of the form

 singleton Name: XIfc;

is mapped to a C++ class with the same name. The class has a single member function

  static com::sun::star::uno::Reference< XIfc > get(
      com::sun::star::uno::Reference< com::sun::star::uno::XComponentContext > const & context) 
      throw (com::sun::star::uno::RuntimeException) { ... }

The semantics of such a singleton getter function in C++ are as follows (they are the same as for Java):

  • The argument must be non-null.
  • The singleton getter uses 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 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 services are not mapped into the C++ language binding.

Content on this page is licensed under the Public Documentation License (PDL).
Personal tools
In other languages