Oracle AQ 的使用.doc

Oracle AQ 的使用（）随着不同应用模块间的消息交互和通信成为一个关键的功能，并且变得越来越重要。Oracle引入了一种强大的队列机制，通过它程序间可以实现信息的交互，oracle把它称作为AQ - Advanced Queuing. 使用Oracle AQ，我们不需要安装额外的中间件，它是Oracle数据库的一个功能组件，只要你安装了Oracle 数据库就可以使用AQ了。接下来分两部分来介绍AQ的使用，使用之前我们要创建QUEUE.我们创建一个自己的AQ的管理角色 my_aq_adm_role 和管理用户aqadm，再把Oracle AQ 管理角色 aq_adminstrator_role 授权给my_aq_adm_role.CREATE ROLE my_aq_adm_role;GRANT aq_adminsistator_role TO my_aq_adm_role创建一个用户的角色 my_aq_user_role 和 普通用户aquser ,再把Oracle AQ的用户角色aq_user_role和一些基本操作需要的系统权限授权给 my_aq_adm_roleCREATE ROLE my_aq_user_role;GRANT CREATE session, aq_user_role TO my_aq_user_role;EXEC DBMS_AQADM.GRANT_SYSTEM_PRIVILEGE(privilege = ENQUEUE_ANY,grantee = my_aq_user_role,admin_option = FALSE);EXEC DBMS_AQADM.GRANT_SYSTEM_PRIVILEGE(privilege = DEQUEUE_ANY,grantee = my_aq_user_role,admin_option = FALSE);现在我们创建 AQ管理用户CREATE USER aqadm IDENTIFIED BY aqadmDEFAULT TABLESPACE elathenTEMPORARY TABLESPACE temp;GRANT my_aq_adm_role TO aqadm;GRANT connect, resource TO aqadm; -注意，resource角色一定要授给user,如果resource角色授权给my_aq_adm_role, user将会失去 unlimited tablespace 权限接着为我们下面example创建普通用户CREATE USER aquser IDENTIFIED BY aquserDEFAULET TABLESPACE elathenTEMPORARY TABLESPACE temp;GRANT my_aq_user_role TO aquser;我们将在我们第一个queue中使用object type而不是NUMBER or VARCHAR2作为payload，这使我们更贴近实际应用。(payload是任何消息都使用的一种数据类型和结构). 上面做的工作都需要在DBA的权限下做，现在我们切换到AQ管理员CONNECT aqadm/aqadmCREATE TYPE queue_message_type AS OBJECT(no NUBER,title VARCHAR2(30),text VARCHAR2(2000);/GRANT EXECUTE ON queue_message_type TO my_aq_user_role;我们再创建一个叫message_queue的queue以及相应的queue table queue_message_table,然后启动queue，这样我们就可以使用了。1.PL/SQL中使用AQ和java使用oracle本地AQ点对点模型(The Point-to-point Model)在简单的系统中，我们可以认为两个系统一起使用一个或多个Queue。这种方法我们称作点对点模型。把消息输入到queue中的过程称为入列(Enqueue)相反的过程称为出列(Dequeue)。一条消息一次只能被一个使用这个queue的应用系统Dequeue，当其他应用系统可以浏览这个queue。这种模式就是点对点模式(the point-point Model)PL/SQL中使用AQ使用aquser连接到数据库CONNECT aquser/aquser现在我们Enqueue一条消息.DECLAREqueue_optionsDBMS_AQ.enqueue_options_t;message_properties DBMS_AQ.message_properties_t;message_idRAW(16);my_messageaqadm.queue_message_type;BEGINmy_message := aqadm.queue_message_type(1,This is a sample message,This message has been posted on | to_char(SYSDATE,DD.MM.YYYY HH24:MI:SS);DBMS_AQ.enqueue(queue_name = aqadm.message_queue,enqueue_options = queue_options,message_properties = message_properties,payload = my_message,msgid = message_id);COMMIT;END;/我们现在Dequeue刚才入列的消息，先执行SET SERVEROUTPUT ON然后DECLAREqueue_options DBMS_AQ.DEQUEUE_OPTIONS_T;message_properties DBMS_AQ.MESSAGE_PROPERTIES_T;message_id RAW(2000);my_message aqadm.queue_message_type;BEGINDBMS_AQ.DEQUEUE(queue_name = aqadm.message_queue,dequeue_options = queue_options,message_properties = message_properties,payload = my_message,msgid = message_id );COMMIT;DBMS_OUTPUT.PUT_LINE(Dequeued no: | my_message.no);DBMS_OUTPUT.PUT_LINE(Dequeued title: | my_message.title);DBMS_OUTPUT.PUT_LINE(Dequeued text: | my_message.text);END;/上面的PL/SQL的例子比较简单和直接，任何应用和编程环境都可以这样做。然而实际项目中，可能用编程语言来处理消息会更便利和更有实用价值。接下来我们将讨论在java中使用AQJava 中使用Oracle Native AQ在前面的例子里我们为队列消息创建了一个Oracle Object type queue_message_type,在java语言中我们不能使用Oracle的数据类型，因此我们要创建一个和queue_message_type对应的java类。我们可以使用Oracle Jpublisher,通过它，我们可以创建一个和Oracle Object type对应的java类。(这里就不具体讨论JPublisher用法)这里我们用JPubisher创建一个和Oracle Object type queue_message_type对应java class QUEUE_MESSAGE_TYPE 在使用Oracle Native AQ对java的interface之前，我们必须通过jdbc连接到数据库，代码如下/loads the Oracle JDBC driverClass.forName(oracle.jdbc.driver.OracleDriver;NativeAQ aq = new NativeAQ();/DB connection, HOST - 数据库所在的机器domian id SID-数据的service nameaq.connection = DriverManager.getConnection(jdbcracle:thin:HOST:1521:SID,aquser,aquesr/aq.connection.setAutoCommit(false);然后我们通过传入AQ connection来获取AQ session对象/loads the Oracle AQ driver Class.forName(oracle.AQ.AQOracleDriver;aq.session = AQDriverManager.createAQSession(aq.connection);上述工作做好后，我们可以获取我们需要的queue对象了,进行出列的操作。AQQueue queue = aq.session.getQueue(aqadm,MESSAGE_QUEUEAQDequeueOption dequeueOption = new AQDequeueOption();System.out.println(Waiting for message to dequeue.;AQMessage message = (AQOracleQueue)queue).dequeue(dequeueOption,QUEUE_MESSAGE_TYPE.getFactory();把raw payload 转换成我们消息类型AQObjectPayload payload = message.getObjectPayload();QUEUE_MESSAGE_TYPE messageData = (QUEUE_MESSAGE_TYPE