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

翻訳前ページへ


Interface XObjectNames
Language

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

API

SDK

Tips ‘n’ Tricks

Miscellaneous


:: com :: sun :: 星/主役にする :: sdb :: 道具s ::

interface XObjectNames
Description
encapsulates functionality which you might find useful when 令状ing a database 使用/適用 which 取引,協定s with query and (米)棚上げする/(英)提議する 指名するs.

The most important 仕事 実行するd by this instance is that it hides different 指名するing 制限s from you, which are 原因(となる)d by server-味方する or (弁護士の)依頼人 味方する specialities.

For instance, it can 実証する 指名するs against the characters 許すd in the 反対する 指名するs of a 関係. Also, it relieves you from caring whether a database supports queries in a SELECT statment's FROM part (known as "queries in queries"). In such databases, query and (米)棚上げする/(英)提議する 指名するs 株 a ありふれた namespace, thus they must be unique. Using this interface, you can easily 確実にする this uniqueness.

All of the functionality 現在の in this interface depends on a 関係, thus it 入ること/参加(者) point for 得るing it is a ::com::sun::星/主役にする::sdb::関係 service.

The 構成要素 itself does not have life-time 支配(する)/統制する mechanimns, i.e. you cannot explicitly 配置する/処分する/したい気持ちにさせる it (::com::sun::星/主役にする::lang::XComponent::配置する/処分する/したい気持ちにさせる), and you cannot be 通知するd when it dies.
However, if your try to 接近 any of its methods or せいにするs, after the 関係 which was used to create it was の近くにd, a ::com::sun::星/主役にする::lang::DisposedException will be thrown.

Since
OOo 2.0.4
See also
XConnectionTools

Methods' 要約
suggestName 示唆するs a (unique) (米)棚上げする/(英)提議する or query 指名する  
convertToSQLName 変えるs the given 反対する 指名する to a 指名する which is valid in the database.  
isNameUsed checks whether a given 指名する is used as (米)棚上げする/(英)提議する それぞれ query 指名する in the database.  
isNameValid checks whether a given 指名する is valid as (米)棚上げする/(英)提議する or query 指名する  
checkNameForCreate checks whether a given 指名する is 許すd for a to-be-created (米)棚上げする/(英)提議する or query in the database.  
Methods' 詳細(に述べる)s
suggestName
string
suggestName( [in] long  CommandType,
[in] string  BaseName )
raises( ::com::sun::星/主役にする::lang::IllegalArgumentException );

Description
示唆するs a (unique) (米)棚上げする/(英)提議する or query 指名する

If in the database, (米)棚上げする/(英)提議するs and queries 株 a ありふれた namespace, this will be 尊敬(する)・点d by this 機能(する)/行事.

公式文書,認める that in an multi-threaded 環境, the 指名する you 得る here is not 絶対 保証(人)d to be unique. It is unique at the very moment the 機能(する)/行事 returns to you. But already when you 評価する the returned value, it might not be uniquey anymore, if another 過程 or thread created a query or (米)棚上げする/(英)提議する with this 指名する.

This 暗示するs that you cannot rely on the 指名する's uniqueness, but you can use it as first guess to 現在の to the 使用者. In most 事例/患者s, it will still be 十分な when you are 現実に creating the (米)棚上げする/(英)提議する それぞれ query.

Parameter CommandType
明示するs the ::com::sun::星/主役にする::sdb::CommandType of the 反対する for which a unique 指名する is to be 生成するd. Must be either ::com::sun::星/主役にする::sdb::CommandType::TABLE or ::com::sun::星/主役にする::sdb::CommandType::QUERY.
Parameter BaseName
明示するs the base of the to-be-created 反対する 指名する. If empty, a default base 指名する will be used.
Throws
com::sun::星/主役にする::lang::IllegalArgumentException if CommandType 明示するs an 無効の 命令(する) type.
convertToSQLName
string
convertToSQLName( [in] string  指名する );

Description
変えるs the given 反対する 指名する to a 指名する which is valid in the database.

The 転換 takes place by 変えるing every character which is neither 許すd by the SQL-92 基準, nor part of the special characters supported by the database, with an 強調する character (_).

See also
::com::sun::星/主役にする::sdbc::XDatabaseMetaData::getExtraNameCharacters
isNameUsed
boolean
isNameUsed( [in] long  CommandType,
[in] string  指名する )
raises( ::com::sun::星/主役にする::lang::IllegalArgumentException );

Description
checks whether a given 指名する is used as (米)棚上げする/(英)提議する それぞれ query 指名する in the database.

If in the database, (米)棚上げする/(英)提議するs and queries 株 a ありふれた namespace, this will be 尊敬(する)・点d by this 機能(する)/行事.

As before, the (警察などへの)密告,告訴(状) you 得る by calling this method might be obsolete in the very moment you 評価する this, in 事例/患者 another 過程 or thread 干渉するs. However, it's usually 十分に up-to-date for 目的 of using it in a database 使用/適用 driven by 使用者 interactions.

Parameter CommandType
明示するs the ::com::sun::星/主役にする::sdb::CommandType of the 反対する whose 指名する should be checked. Must be either ::com::sun::星/主役にする::sdb::CommandType::TABLE or ::com::sun::星/主役にする::sdb::CommandType::QUERY.
Parameter 指名する
明示するs the to-be-checked 指名する of the 反対する.
Returns
true if and only if the given 指名する is 合法的 as (米)棚上げする/(英)提議する それぞれ query 指名する to be used in the database.
Throws
com::sun::星/主役にする::lang::IllegalArgumentException if CommandType 明示するs an 無効の 命令(する) type.
See also
checkNameIsUsed
isNameValid
boolean
isNameValid( [in] long  CommandType,
[in] string  指名する )
raises( ::com::sun::星/主役にする::lang::IllegalArgumentException );

Description
checks whether a given 指名する is valid as (米)棚上げする/(英)提議する or query 指名する

For (米)棚上げする/(英)提議するs, the 指名する must consist of characters 許すd by the SQL-92 基準, 加える characters 許すd by the 関係 as extra 指名する characters.

For queries, 指名するs are nearly 独断的な, except that usual 引用するing characters must not be part of the 指名する.

See also
::com::sun::星/主役にする::sdbc::XDatabaseMetaData::getExtraNameCharacters
checkNameForCreate
無効の
checkNameForCreate( [in] long  CommandType,
[in] string  指名する )
raises( ::com::sun::星/主役にする::sdbc::SQLException );

Description
checks whether a given 指名する is 許すd for a to-be-created (米)棚上げする/(英)提議する or query in the database.

This method 基本的に does the same checks as isNameUsed and isNameValid. In 事例/患者 the given 指名する is not 許すd, it throws an exception. This error can be 現在のd to the 使用者, to give it a ありふれた experience in all 事例/患者s where he's 要求するd to enter an 反対する 指名する.

See also
isNameUsed, isNameValid, ::com::sun::星/主役にする::sdb::ErrorMessageDialog, ::com::sun::星/主役にする::sdb::InteractionHandler
最高の,を越す 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.