Registrando para Rastreio

Use o método registerApplication() para especificar o aplicativo a ser registrado com rastreio de aplicativo.

O método tem o formato:

int registerApplication(String application_name, String[] format_template)

O argumento application_name é o nome do aplicativo que você deseja rastrear. O nome deve ser igual ao nome do aplicativo especificado na inicialização da JVM. O argumento format_template é uma matriz de cadeias com formato semelhante às cadeias usadas pelo método printf. É possível especificar modelos de até 16 KB. A posição na matriz determina o identificador do ponto de rastreio (iniciando em 0). Você pode usar esses identificadores para ativar pontos de rastreio específicos no tempo de execução. O primeiro caractere de cada modelo é um dígito que identifica o tipo de ponto de rastreio. O tipo de ponto de rastreio pode ser uma entrada, saída, evento, exceção ou saída de exceção. Depois do caractere de tipo de ponto de rastreio, o modelo tem um caractere em branco, seguido pela cadeia de formatação.

Os tipos de rastreio são definidos como valores estáticos dentro da classe Trace:

public static final String EVENT= "0 ";
public static final String EXCEPTION= "1 ";
public static final String ENTRY= "2 ";
public static final String EXIT= "4 ";
public static final String EXCEPTION_EXIT= "5 ";

O método registerApplication() retorna um valor de número inteiro. Use esse valor nas chamadas trace() subsequentes. Se a chamada de método registerApplication() falhar por qualquer razão, o valor retornado será -1.