このページはEtoJ逐語翻訳フィルタによって翻訳生成されました。

翻訳前ページへ


Service ConfigurationProvider
Language

The 解放する/自由な and Open 生産性 控訴
解放(する)d: Apache OpenOffice 4.1.16

API

SDK

Tips ‘n’ Tricks

Miscellaneous


:: com :: sun :: 星/主役にする :: configuration ::

service ConfigurationProvider
Description
manages one, or more, 完全にする 始める,決めるs of configuration data and serves as a factory for 反対するs that 供給する 接近 to a subset of the configuration.

An 実施 is usually 得るd from a ::com::sun::星/主役にする::lang::ServiceManager. The arguments passed to ::com::sun::星/主役にする::lang::XMultiComponentFactory::createInstanceWithContextAndArguments() select the configuration data source. Arguments must be 供給するd as ::com::sun::星/主役にする::beans::NamedValue or ::com::sun::星/主役にする::beans::PropertyValue. If the parameters given are incomplete 行方不明の values are taken from the 状況 or the 環境. If an instance already 存在するs for the given 始める,決める of arguments, the 存在するing instance may be 再使用するd. In particular, instantiating a provider without explicit arguments to 接近 the default configuration data will always 産する/生じる the same DefaultProvider 反対する.

Some arguments for ::com::sun::星/主役にする::lang::XMultiServiceFactory::createInstanceWithArguments() may be given default values during 創造 of this service. In particular this 適用するs to the parameters "地元の" and "EnableAsync".

Developers Guide
WritingUNO - 無能にする 命令(する)s - 無能にするing 命令(する)s at Runtime
Config - Connecting to a Data Source
Config - 反対する Model

輸出(する)d Interfaces - 要約
::com::sun::星/主役にする::lang::XMultiServiceFactory

許すs creating 接近 反対するs for 明確な/細部 見解(をとる)s such as subsets and fragments of the configuration. (詳細(に述べる)s)

::com::sun::星/主役にする::lang::XComponent

許すs controlling or 観察するing the lifetime of the configuration. (詳細(に述べる)s)

輸出(する)d Interfaces - 詳細(に述べる)s
::com::sun::星/主役にする::lang::XMultiServiceFactory
Description
許すs creating 接近 反対するs for 明確な/細部 見解(をとる)s such as subsets and fragments of the configuration.

The parameter aServiceSpecifier passed to ::com::sun::星/主役にする::lang::XMultiServiceFactory::createInstanceWithArguments() supports at least the service specifiers "com.sun.星/主役にする.configuration.ConfigurationAccess" and "com.sun.星/主役にする.configuration.ConfigurationUpdateAccess".

Using the first of these service specifiers requests a read-only 見解(をとる) of the configuration. The 反対する that is created 器具/実施するs service ConfigurationAccess. To 反映する its element 役割 as root of the 見解(をとる), it 器具/実施するs service AccessRootElement.

Using the second form requests an updatable 見解(をとる) of the configuration. The 反対する that is created should 器具/実施する service ConfigurationUpdateAccess. To 反映する its element 役割 which 含むs controlling updates for the whole 見解(をとる), it 器具/実施するs service UpdateRootElement.
If the root element of the 見解(をとる) is 示すd read-only (as 示すd by PropertyAttributes::READONLY), the 実施 may either raise an exception or return a (read-only) ConfigurationAccess/AccessRootElement instead.

The arguments passed to ::com::sun::星/主役にする::lang::XMultiServiceFactory::createInstanceWithArguments() in parameter aArguments 明示する the 見解(をとる) of the configuration that should be created. That is, they 決定する the subset of elements that can be 接近d starting from the returned 反対する. Each element of the argument sequence should be a ::com::sun::星/主役にする::beans::PropertyValue or a ::com::sun::星/主役にする::beans::NamedValue, so that the parameters can be identified by 指名する rather than by position.

What combinations of arguments are supported depends on the service 指名する.

With both of the 基準 service-specifiers above, an 実施 must 受託する a 選び出す/独身 argument 指名するd nodepath of type string. This argument must 含む/封じ込める the 絶対の path to an element of the configuration. The 見解(をとる) that is selected consists of the 指名するd element and all its decendants.

Other arguments can be used to 支配(する)/統制する the 行為 of the 見解(をとる). These are different for different 実施s. Whether and how they are used may also depend on the configuration 蓄える/店 and configuration that were selected when the provider was created.

An 実施 must ignore unknown arguments.

Some parameters that are 一般的に supported are:

  • Selecting data into a 見解(をとる):
    "nodepath" : string
    明示するs the 場所 of the 見解(をとる) root in the configuration.
    "depth" : short
    明示するs that elements of the 階層制度 that are more than the given number of nesting levels away from the root need not be 含むd in the 見解(をとる).
    "地元の" : ::com::sun::星/主役にする::lang::地元の
    明示するs the 地元の for which localized values should be retrieved.

    Example: In the 階層制度

     A - B1 - C1
     |
     - B2 - C2 (localized: de, en, fr, ..)
     | |
     | - C3 - D1 
     | | |
     | | - D2 - E1
     | | 
     | - C4 - D3 - E2 - F1
     | | |
     | | - F2
     | |
     | - C5
     |
     - B3
     |
     - B4 - C6 - D4 - E3 
    
    

    selecting a 見解(をとる) with nodepath = "/A/B2", depth = 2 and 地元の = <地元の for en_US> would result in the tree fragment
    (A-) B2 - C2 (en)
     |
     - C3 - D1
     | |
     | - D2 (..)
     | 
     - C4 - D3 (..) 
     |
     - C5
    
    

  • Controlling (武器などの)隠匿場所 行為: (with providers that (武器などの)隠匿場所 configuration data)
    "enableasync" : boolean
    支配(する)/統制するs how updates are 扱うd in the (武器などの)隠匿場所. If true, the (武器などの)隠匿場所 may operate in 令状-支援する 方式, where updates at first only 影響する/感情 the (武器などの)隠匿場所 and are written to 執拗な 貯蔵 at some later time. If 誤った, the (武器などの)隠匿場所 must operate in 令状-through 方式, where updates are written to 執拗な 貯蔵 at once - that is before ::com::sun::星/主役にする::util::XChangesBatch::commitChanges() returns.

    This parameter was 以前は called "lazywrite". The old 指名する should still be supported for compatibility.

    "nocache" : boolean
    This deprecated parameter 明示するs that data for the 見解(をとる) is not taken from the (武器などの)隠匿場所, but read 直接/まっすぐに from 貯蔵. This may entail that 未来 changes that become 明白な in the (武器などの)隠匿場所 are not 反映するd in this 見解(をとる) and that changes done through this 見解(をとる) are not 反映するd in the (武器などの)隠匿場所.
    Use with 警告を与える !

    This parameter is not supported by all 実施s and may be silently ignored !

::com::sun::星/主役にする::lang::XMultiServiceFactory::createInstance() may be unusable. Only an 実施 that supports service 指名するs that can be used with no その上の arguments support this method. It should return the same result as if ::com::sun::星/主役にする::lang::XMultiServiceFactory::createInstanceWithArguments() had been called using an empty sequence of arguments.

::com::sun::星/主役にする::lang::XComponent
Description
許すs controlling or 観察するing the lifetime of the configuration.

The owner of the provider may 配置する/処分する/したい気持ちにさせる of this 反対する using ::com::sun::星/主役にする::lang::XComponent::配置する/処分する/したい気持ちにさせる(). 公式文書,認める that the default provider is owned by the ::com::sun::星/主役にする::lang::ServiceManager and should not be 性質の/したい気がして of by 使用者 code.

見解(をとる)s created by the provider 一般に 言及する to data that is managed by the provider. Therefore, 配置する/処分する/したい気持ちにさせるing of the provider will 原因(となる) all 反対するs belonging to these 見解(をとる)s to be 性質の/したい気がして of 同様に. This does not 適用する to snapshot 見解(をとる)s that have their own copy of the data, if 利用できる.


 
最高の,を越す of Page

The ASF

Copyright & License | Privacy | 接触する Us | 寄付する | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are 登録(する)d trademarks of The Apache ソフトウェア 創立/基礎. The ASF logo is a trademark of The Apache ソフトウェア 創立/基礎. Other 指名するs appearing on the 場所/位置 may be trademarks of their 各々の owners.