Тренинги по Oracle Unified Method

Тренинги по Oracle Unified Method доступны на Oracle Learning Library.
На момент написания статьи доступно два уровня OUM:

• Level 1 - Overview and Awareness
• Level 2:
• Implement Focus Area Overview
• Envision Focus Area Overview
• Manage Focus Area Overview
• Use Case Overview

Все тренинги по OUM на Oracle Learning Library здесь.

Полезные ссылки:

• Официальный блог здесь
• Информация об сертификации Oracle Unified Method 5 Essentials (1Z0-568) здесь

Ошибка "internal xpath error" в oraext:query-database и вариант её решения

Ошибка:
При использовании XPath-функции oraext:query-database, если в запросе используются функции БД (например: select max(salary) from employee) возникает ошибка следующего вида:

 <bpelFault>  
  <faultType>0</faultType>  
  <subLanguageExecutionFault xmlns="http://docs.oasis-open.org/wsbpel/2.0/process/executable">  
   <part name="summary">  
    <summary>An error occurs while processing the XPath expression; the  
         expression is oraext:query-database("select  
         max(salary) from employee",false(),false(),'jdbc/examplesDS').</summary>  
   </part>  
   <part name="detail">  
    <detail>XPath expression failed to execute. An error occurs while  
        processing the XPath expression; the expression is  
        oraext:query-database("select max(salary) from  
        employee",false(),false(),'jdbc/examplesDS'). The XPath  
        expression failed to execute; the reason was: internal xpath  
        error. Check the detailed root cause described in the exception  
        message text and verify that the XPath query is correct.</detail>  
   </part>  
   <part name="code">  
    <code>XPath expression failed to execute</code>  
   </part>  
  </subLanguageExecutionFault>  
 </bpelFault>  

А в логе managed-сервера:

 oracle.xml.sql.OracleXMLSQLException: Character ')' is not allowed in an XML tag name.  
     at oracle.xml.sql.core.OracleXMLConvert.getXML(OracleXMLConvert.java:1178)  
     at oracle.xml.sql.query.OracleXMLQuery.getXMLDOM(OracleXMLQuery.java:417)  
     at oracle.xml.sql.query.OracleXMLQuery.getXMLDOM(OracleXMLQuery.java:384)  
     at oracle.xml.sql.query.OracleXMLQuery.getXMLDOM(OracleXMLQuery.java:345)  
     at oracle.tip.pc.services.functions.ExtFunc.queryDatabase(ExtFunc.java:152)  
     at oracle.tip.pc.services.functions.ExtFuncFunction$QueryDatabaseFunction.call(ExtFuncFunction.java:359)
     ...

Причина:
XML SQL Utility (XSU) обрабатывает имя столбца как имя тега. В нашем случае имя столбца max(salary) рассматривается XSU как недопустимое имя тега, и происходит ошибка.

Вариант решения:
Необходимо добавить алиас для столбца в котором используются функции, т.е. в нашем случае:

 oraext:query-database("select max(salary) as salary from employee",
                                       false(),false(),'jdbc/examplesDS')  

Хеширование SHA-1 и MD5 на PL/SQL и Java

• Реализация на PL/SQL:
  • SHA-1:

     CREATE OR REPLACE  
      FUNCTION SHA1(plain_text VARCHAR2) RETURN VARCHAR2  
      AS  
      BEGIN  
       RETURN UTL_RAW.CAST_TO_VARCHAR2(UTL_ENCODE.BASE64_ENCODE(DBMS_CRYPTO.HASH (src => utl_i18n.string_to_raw (plain_text, 'AL32UTF8'), typ => DBMS_CRYPTO.HASH_SH1)));  
      END;  
    

  • MD5:

     CREATE OR REPLACE  
      FUNCTION MD5(plain_text VARCHAR2) RETURN VARCHAR2 IS  
      BEGIN  
       RETURN RAWTOHEX(DBMS_OBFUSCATION_TOOLKIT.MD5(INPUT => TL_RAW.CAST_TO_RAW(plain_text) ));  
      END;
    

• Реализация на Java:

  import java.math.BigInteger;
  
  import java.security.MessageDigest;
  import java.security.NoSuchAlgorithmException;
  
  public class CryptoUtils {
  
      private final static char[] ALPHABET =
          "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".toCharArray();
  
      public static String sha1(String plain) {
          try {
              MessageDigest md = MessageDigest.getInstance("sha");
              md.update(plain.getBytes());
              byte[] digest = md.digest();
  
              return encode(digest);
              /* Альтернативные варианты:
              return javax.xml.bind.DatatypeConverter.printBase64Binary(digest);
              или
              return com.sun.org.apache.xml.internal.security.utils.Base64.encode(digest);
              */
          } catch (NoSuchAlgorithmException e) {
              e.printStackTrace();
              return null;
          }
      }
  
      public static String md5(String raw) {
          try {
              MessageDigest md = MessageDigest.getInstance("MD5");
              md.update(raw.getBytes(), 0, raw.length());
              return new BigInteger(1, md.digest()).toString(16);
          } catch (NoSuchAlgorithmException e) {
              e.printStackTrace();
              return null;
          }
      }
  
      public static String encode(byte[] buf) {
          int size = buf.length;
          char[] ar = new char[((size + 2) / 3) * 4];
          int a = 0;
          int i = 0;
          while (i < size) {
              byte b0 = buf[i++];
              byte b1 = (i < size) ? buf[i++] : 0;
              byte b2 = (i < size) ? buf[i++] : 0;
  
              int mask = 0x3F;
              ar[a++] = ALPHABET[(b0 >> 2) & mask];
              ar[a++] = ALPHABET[((b0 << 4) | ((b1 & 0xFF) >> 4)) & mask];
              ar[a++] = ALPHABET[((b1 << 2) | ((b2 & 0xFF) >> 6)) & mask];
              ar[a++] = ALPHABET[b2 & mask];
          }
          switch (size % 3) {
          case 1:
              ar[--a] = '=';
          case 2:
              ar[--a] = '=';
          }
          return new String(ar);
      }
  }
  

Управление структурой MDS с помощью MDS Explorer

  MDS Explorer - это OpenSource-проект, цель которого создание средства для доступа к Oracle MDS (Meta Data Services) репозиториям с помощью которого можно создавать, удалять, загружать, выгружать директории и файлы.
  На сайте проекта можно скачать исходники (в скомпилированном виде отсутствуют). В скомпилированном виде в одном jar-файле выкладываю здесь.
  Запуск:

1. Выполнить следующую команду:

    java -Drepository.flavor=DB -jar MDSExplorer.jar  
   

   где DB - для доступа к репозиторию в БД;
       FILE - для доступа к репозиторию в файловой системе.
2. Ввести параметры соединения со схемой MDS, затем нажать "Connect", выбрать нужный раздел (partition) и нажать "OK":
   
3. В открывшемся окне можно выполнять действия по управлению структурой MDS:
   

Удаление метаданных из MDS

Все команды выполняются из wlst.cmd или wlst.sh находящегося в SOA_HOME, у меня например это:

 C:\Apps\Oracle\Weblogic\10.3.6\Oracle_SOA1\common\bin\wlst.cmd  

• Удаление файлов
  Примечание: удаляются файлы, но не каталоги:
  1. Соединяемся с SOA-сервером:

     wls:/offline> 
      connect('weblogic','welcome1','t3://bpm-dev.mycompany.com:8001')  
     

     где weblogic - логин административного пользователя;
     welcome1 - пароль административного пользователя;
     bpm-dev.mycompany.com - хост SOA-сервера;
     8001 - порт SOA-сервера.
  2. Выполняем удаление файлов:

     wls:/soa_dev/serverConfig>
      deleteMetadata('soa-infra','soa_server1','/apps/MyComponents/**')  
     

     где soa_server1 - имя SOA-сервера;
     /apps/MyComponents - директория из которой будут удаляться файлы;
     ** - удаление в текущем каталоги в всех вложенных каталогах.
• Удаление каталогов (рекурсивное)
  Примечание: если в удаляемом каталоге нет ни одного файла может произойти ошибка и каталог не будет удалён.

  wls:/offline>
   sca_removeSharedData('http://bpm-dev.mycompany.com:8001', 
                        'MyComponents',
                        'weblogic',
                        'welcome1')  
  

  где bpm-dev.mycompany.com - хост SOA-сервера;
  8001 - http-порт SOA-сервера;
  MyComponents - директория из корневой директории apps которую следует удалить;
  weblogic - логин административного пользователя;
  welcome1 - пароль административного пользователя.