Artigos Banco de Dados PL/SQL Wrapper

Muitas vezes necessitamos enviar aplicações de PL/SQL para instalação em ambientes externos ao de nossa instalação. O código enviado, de um modo geral, fica exposto e passível de modificações indesejáveis. A rotina Wrapper tem a finalidade de criptografar o código-fonte de tal forma que somente o Oracle tenha condições de ler e compilar o texto gerado.

Tem como Características:

  • Converte o código-fonte de PL/SQL em uma forma intermediária de código-objeto.
  • Código-objeto gerado é portável como se fosse o próprio fonte.
  • O compilador PL/SQL reconhece e carrega o código gerado pelo Wrapper automaticamente.

Tem como Vantagens:

  • Impede que o código-fonte seja manuseado por outros desenvolvedores;
  • Independência de plataforma, já que se trata de uma versão de código portável;
  • As referências a variáveis Bind externas são resolvidas a tempo de carga;
  • Os processos de Import / Export normais aceitam arquivos gerados pela rotina Rappel.

Criando o código intermediário:

A rotina Wrapper não é executada pelo banco de dados. É uma rotina externa e deve ser executada no sistema operacional em uso. No caso da instalação em Windows, ela se encontra no diretório <Oracle Home>\bin e se chama Wrap.exe.

Sintaxe Wrapper: wrap iname=<nome fonte>oname=<nome codigo></nome>

Não deve haver espaço nem antes nem depois dos sinais de igual. A extensão default para arquivo de entrada é .SQL e para arquivo de saída é .PLB. Caso o arquivo de saída não seja especificado, será gerado com o mesmo nome do arquivo de entrada, com apenas a diferença de extensão.

Tem como Restrições:

Não podemos passar para a rotina Wrapper um bloco anônimo de PL/SQL.1

Apenas fontes contendo os comandos a seguir podem ser codificadas:

  • create procedure;
  • create function;
  • create package;
  • create package body;

Todos os outros comandos são passados intactos para o arquivo de saída. As linhas com comentários (contendo REM ou --) são removidas do código gerado a menos que estejam incluídas na parte de especificação.

Criação da rotina Master:

SQL> CREATE OR REPLACE PROCEDURE MASTER IS

RETORNO      NUMBER;

TEXTO          VARCHAR2(100);

  BEGIN

RETORNO := DBMS_PIPE.RECEIVE_MESSAGE( 'Teste',20);

IF RETORNO <> 0 THEN

     RAISEN_APPLICATION_ERROR ( -20002, 'erro na recepção da ' || 'mensagem do Pipe -

                                                '||Retorno);

   ELSE

LOOP

     RETORNO := DBMS_PIPE..NEXT_ITEM_TYPE;

          EXIT WHEN RETORNO = 0;

     DBMS_PIPE.UNPACK_MESSAGE(TEXTO);

          DBMS.OUT.PUT_LINE(TEXTO);

      END LOOP;

    END IF;

  END;

  /

A rotina acima apresenta o comando a ser passado para a rotina Wrap. Nos parâmetros INAME e ONAME podemos informar o diretório completo onde se acham os programas. No exemplo isto não foi feito pois a execução do comando (no DOS) foi feita dentro do diretório onde se achavam o fonte a ser convertido.

Linha de código da Wrap:

wrap iname=103_205.sql oname=s03_205.plb

Trecho de código da rotina MASTER:

SQL> CREATE OR REPLACE PROCEDURE MASTER wrapped

0

abcd

abcd

abcd

abcd

---------------------------------

     1UNPACK_MESSAGE;

     1DBMS_OUTPUT;

1PUT_LINE;

0



0

0

59

2

0 9a b4 55 6a a3 a0 lc

8l b0 a3 a0 5l0a5 lc 8l

b0 :3 a0 6b 6e 5l a5 b d

a0 7e 5l b4 2e 7e

a0 b4 2e a5 57 b7 :4 a0 6b

d :2 a0 7e 5l b4 2e 2b a0

O código torna-se, de um modo geral, maior que o fonte original.

Para maiores detalhes , você pode ler a PL/SQL User's Guide and Reference

para download no endereço