コンテキスト情報インジェクション
操作またはソースが処理されるコンテキストに関する情報を取得するため、操作またはソースにパラメーターを追加できます。パラメーターは UI には表示されませんが、SDK によってランタイムに挿入されます。
コンポーネントの場所
操作を実行したりソースを使用したりするときに、主にログ記録の目的で、コンポーネントの場所に関するコンテキストが必要になる場合があります。これを実現するため、ComponentLocation をパラメーターとして定義し、それを挿入できます。
次の例は、ソースを開始するときにコンポーネントの場所をログに記録する方法を示しています。
@Alias("listener")
public class HttpListener extends Source<InputStream, HttpRequestAttributes> {
private static final Logger LOGGER = getLogger(HttpListener.class);
@Connection
private ConnectionProvider<HttpServer> serverProvider;
private ComponentLocation location;
@Parameter
private String path;
private HttpServer server;
@Override
public void onStart(SourceCallback<InputStream, HttpRequestAttributes> sourceCallback) throws MuleException {
server = serverProvider.connect();
if (LOGGER.isDebugEnabled()) {
LOGGER.debug("Starting HTTP Listener %s on path %s", location.getLocation(), path);
}
server.listen(path);
}
// ...
}次の例は、操作 (ソースなし) のコンテキストでコンポーネントの場所をログに記録する方法を示しています。
//ComponentLocation is added as a parameter when used in an operation
public String sayHi(String person, String q, ComponentLocation location) {
// ...
System.out.println("Location: " + location.getLocation());
// ...
}イベントの追跡
バージョン 1.1 以降で使用可能
ログを使用してイベントを追跡できるようにするには、操作およびソースコールバックで CorrelationInfo パラメーターを使用します。この相関関係情報により、処理されるイベントのイベント ID と相関関係 ID が提供されます。
CorrelationInfo パラメーターを操作メソッドまたはソースコールバックに追加する必要があるだけです。インスタンスには、メソッドまたはコールバックが実行するイベント情報が入力されます。
次の簡単な例は、CorrelationInfo の使用方法を示しています。
public class ObjectStoreOperations {
private static final Logger LOGGER = getLogger(ObjectStoreOperations.class);
// ...
@Throws(StoreErrorTypeProvider.class)
public void store(String key,
@Content TypedValue<Serializable> value,
ObjectStore objectStore,
CorrelationInfo correlationInfo) {
objectStore.store(key, value);
if (LOGGER.isDebugEnabled()) {
LOGGER.debug("Object stored with key: %s .The event id is: %s", key, correlationInfo.getEventId());
}
}
// ...
}