monitoring-shared-states.md

Monitoring shared states

To monitor changes to a shared state, register an event listener by using registerListener API. You need to pass a com.adobe.eventType.hub event type and a com.adobe.eventSource.sharedState event source. This listener is now be called when the shared state changes for any extension. To check an extension’s or an internal module’s shared state, check the stateowner key in the event data.

In the example below, you can find the listener that is being registered in the extension’s init method and the listener implementation where the shared state check is happening. The extension is checking for changes to the com.adobe.module.configuration shared state.

{% tabs %} {% tab title="Android" %}

Java

MyExtension.java

MyExtension(final ExtensionApi extensionApi) {
    super(extensionApi);
    ExtensionErrorCallback<ExtensionError> errorCallback = new ExtensionErrorCallback<ExtensionError>() {
        @Override
        public void error(final ExtensionError extensionError) {
            Log.e("MyExtension", String.format("An error occurred while registering MySharedStateListener %d %s", extensionError.getErrorCode(), extensionError.getErrorName()));
        }
    };

    getApi().registerEventListener("com.adobe.eventType.hub", "com.adobe.eventSource.sharedState", MySharedStateListener.class, errorCallback);
}

MySharedStateListener.java

@Override
public void hear(final Event event) {
    Map<String, Object> eventData = event.getEventData();
    if (eventData == null) {
        return;
    }

    String stateOwner = (String) eventData.get("stateowner");
    if ("com.adobe.module.configuration".equals(stateOwner)) {
        // do something with the updated configuration information
    }
}

{% endtab %}

{% tab title="iOS" %}

Objective-C

MyExtension.m

- (instancetype) init {
    NSError* error = nil;
    if ([self.api registerListener: [MyExtensionListener class] eventType:@"com.adobe.eventType.hub" eventSource:@"com.adobe.eventSource.sharedState" error:&error]) {  
        NSLog(@"MyExtensionListener was registered");
   } else if (error) {  
           NSLog(@"An error occured while registering MyExtensionListener: %ld", [error code]);
    }
}

MyExtensionListener.m

- (void) hear:(ACPExtensionEvent *)event {
    NSDictionary* eventDataDict = event.eventData;
    NSString* stateowner = [eventDataDict objectForKey:@"stateowner"];
    if (stateowner && [stateowner isEqualToString:@"com.adobe.module.configuration"]) {  
        // do something with the updated configuration information
      }
}

{% endtab %} {% endtabs %}