Interstage Application Server J2EE ユーザーズガイド

21.2.10.1 メッセージセレクタ条件式

　条件式はSQL文のWHERE句で使用されるSQL-92の条件式に準拠しています。

例

　color = 'blue'

　上記の条件式の左辺のcolorは識別子といい、フィルタリング時にはJMS Messagesのプロパティ名と比較されます。
　右辺の'blue'はリテラルといい、フィルタリング時にはJMS Messagesのプロパティ値と比較されます。
　リテラルには文字列型リテラルと完全数値リテラルと近似数値リテラルがあります。

　文字列型リテラルはシングルクォートで囲む必要があります。
　完全数値リテラルは57、-957、+62のように小数点なしの数値です。
　近似数値リテラルは7E3、-57.9E2のように指数表記された数値、または7.、-95.7、+6.2のように小数点を含む数値です。

　なお、条件式の文法の詳細については、Javadoc集の“パッケージ javax.jms”の“インタフェース Message”を参照してください。

以下に条件式の例を示します。

• 比較演算条件式
  以下の比較演算子が使用できます。
  =（等しい）
  >（大きい）
  >=（以上）
  <（小さい）
  <=（以下）
  <>（等しくない）

  例：プロパティ名NAMEのプロパティ値が"FUJITSU"のJMS Messagesを受信する場合

  　NAME = 'FUJITSU'

  例：プロパティ名NUMBERのプロパティ値が1000以上のJMS Messagesを受信する場合

  　NUMBER >= 1000

  例：プロパティ名NUMBERのプロパティ値が230以下のJMS Messagesを受信する場合

  　NUMBER <= 10 * 20 + 30

  　このように、算術演算子(+,-,*,/)を使用することができます。

• BETWEEN条件式
  BETWEEN条件式により範囲付きの検索ができます。

  例：プロパティ名NUMBERのプロパティ値が100以上かつ1000以下のJMS Messagesを受信する場合

  　NUMBER BETWEEN 100 AND 1000

  例：プロパティ名NUMBERのプロパティ値が100未満または1000より大きいJMS Messagesを受信する場合

  　NUMBER NOT BETWEEN 100 AND 1000

  　

• LIKE条件式
  LIKE条件式によりパターン検索を使用した検索ができます。
  文字列リテラルに%と_を指定することにより、パターン検索を行います。
  _は任意の1文字を表し、%は任意の文字列を表します。
  オプションであるエスケープ文字は単独の文字リテラルであり、'_'と'%'を単なる文字列として扱う場合に使用されます。

  例：プロパティ名PROPERTYのプロパティ値が"任意の文字+C"のJMS Messagesを受信場合

  　PROPERTY LIKE '%C'

  　プロパティ値がABCやCCCやCの場合は受信できますが、ABの場合は受信できません。

  例：プロパティ名PROPERTYのプロパティ値が"任意の文字+C"以外のJMS Messagesを受信する場合

  　PROPERTY NOT LIKE '%C'

  　プロパティ値が"AB"の場合は受信できますが、"ABC"や"CCC"や"C"の場合は受信できません。

  例：プロパティ名PROPERTYのプロパティ値が"任意の1文字+C"のJMS Messagesを受信する場合

  　PROPERTY LIKE '_C'

  　プロパティ値が"AC"や"CC"の受信できますが、"ABC"や"C"の場合は受信できません。

  例：プロパティ名PROPERTYのプロパティ値が"任意の1文字+本"のJMS Messagesを受信する場合

  　PROPERTY LIKE '__本'

  　プロパティ値が"日本"の受信はできますが、"本"は受信できません。
  　なお、日本語は２バイトなので、１文字に付き'_'が２個必要です。

  例：プロパティ名PROPERTYのプロパティ値が"任意の文字+%+C"のJMS Messagesを受信する場合

  　PROPERTY LIKE '%#%C' ESCAPE '#'

  　プロパティ値が"A%C"の受信はできますが、"AAC"の場合は受信できません。

• NULL条件式
  NULL条件式により、プロパティがあるかどうかの検索ができます。

  例：プロパティ名PROPERTYのプロパティが存在しないJMS Messagesを受信する場合

  　PROPERTY IS NULL

  例：プロパティ名PROPERTYのプロパティが存在するJMS Messagesを受信する場合

  　PROPERTY IS NOT NULL

  　

• IN条件式
  IN条件式により、リスト内の項目を検索することができます。

  例：プロパティ名PROPERTYのプロパティ値が"AAA"または"BBB"または"CCC"ならばJMS Messagesを受信する場合

  　PROPERTY IN ('AAA','BBB','CCC')

  例：プロパティ名PROPERTYのプロパティ値が"AAA"または"BBB"または"CCC"以外の場合にJMS Messagesを受信する場合

  　PROPERTY NOT IN ('AAA','BBB','CCC')

  　

• 条件式の混在
  上記の条件式をNOT,AND,ORにより混在して指定することができます。

  例：プロパティ名NUMBERのプロパティ値が100以上かつ1000以下、またはプロパティ名PROPERTYのプロパティ値が"任意の文字+C"の場合にJMS Messagesを受信する場合

  　(NUMBER BETWEEN 100 AND 1000) OR (PROPERTY LIKE '%C')

  例：プロパティ名NUMBERのプロパティ値が100以上かつ1000以下、かつプロパティ名PROPERTYのプロパティ値が"任意の文字+C"の場合にJMS Messagesを受信

  　(NUMBER BETWEEN 100 AND 1000) AND (PROPERTY LIKE '%C')

  例：プロパティ名NUMBERのプロパティ値が100以上かつ1000以下以外、またはプロパティ名PROPERTYのプロパティ値が"任意の文字+C"以外の場合にJMS Messagesを受信する場合

  　NOT ((NUMBER BETWEEN 100 AND 1000) AND (PROPERTY LIKE '%C'))

  　

• 指定できるメッセージセレクタ文の最大長は4096バイトです。
• 条件式に指定できる識別子および文字列型リテラルの最大長は1024バイトです。
• 条件式内に指定できる識別子と文字列型リテラルの合計の上限は512個です。
• IN条件式に指定できるリスト数の上限は256個です。
• 識別子に日本語を指定することはできません。
• LIKE条件式のESCAPE文字に日本語を指定することはできません。