libs/framework/src/bundle_context_private.h

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 *  KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

#ifndef BUNDLE_CONTEXT_PRIVATE_H_
#define BUNDLE_CONTEXT_PRIVATE_H_

#include "bundle_context.h"
#include "bundle_listener.h"
#include "celix_bundle_context.h"
#include "celix_log.h"
#include "listener_hook_service.h"
#include "service_tracker.h"
#include <stdbool.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef struct celix_bundle_context_bundle_tracker_entry {
	celix_bundle_context_t *ctx;
	long trackerId;
	bundle_listener_t listener;
	celix_bundle_tracking_options_t opts;

    bool created;
    bool cancelled;

    //used for sync
    long createEventId;
} celix_bundle_context_bundle_tracker_entry_t;

typedef struct celix_bundle_context_service_tracker_entry {
	celix_bundle_context_t *ctx;
	long trackerId;
    celix_service_tracking_options_t opts;
	celix_service_tracker_t* tracker;
    void *trackerCreatedCallbackData;
    void (*trackerCreatedCallback)(void *trackerCreatedCallbackData);
    bool isFreeFilterNeeded;

    //used for sync
    long createEventId;
    bool cancelled; //if tracker is stopped before created async
} celix_bundle_context_service_tracker_entry_t;

typedef struct celix_bundle_context_service_tracker_tracker_entry {
	celix_bundle_context_t* ctx;
	long trackerId;

	struct listener_hook_service hook;
	long serviceId;

	char *serviceName;
	void *callbackHandle;
	void (*add)(void *handle, const celix_service_tracker_info_t *info);
	void (*remove)(void *handle, const celix_service_tracker_info_t *info);

    //used for sync
    long createEventId;
} celix_bundle_context_service_tracker_tracker_entry_t;

struct celix_bundle_context {
	celix_framework_t *framework;
	celix_bundle_t *bundle;

	celix_thread_mutex_t mutex; //protects fields below (NOTE/FIXME also used by bundle.c for listing service tracker usage)
	array_list_t *svcRegistrations; //serviceIds
	celix_dependency_manager_t *mng;
	long nextTrackerId;
	hash_map_t *bundleTrackers; //key = trackerId, value = celix_bundle_context_bundle_tracker_entry_t*
	hash_map_t *serviceTrackers; //key = trackerId, value = celix_bundle_context_service_tracker_entry_t*
	hash_map_t *metaTrackers; //key = trackerId, value = celix_bundle_context_service_tracker_tracker_entry_t*
    hash_map_t *stoppingTrackerEventIds; //key = trackerId, value = eventId for stopping the tracker. Note id are only present if the stop tracking is queued.
};

/**
 * @brief Unload the bundle with the provided bundle id. If needed the bundle will be stopped first.
 * Will silently ignore bundle ids < 0.
 * Note that unloaded bundle is kept in bundle cache and can be reloaded with the celix_bundleContext_installBundle function.
 *
 * If this function is called on the Celix event thread, the actual stopping of the bundle will be done async and
 * on a separate thread.
 * If this function is called from a different thread than the Celix event thread, then the function will return after
 * the bundle is stopped.
 *
 * @param ctx The bundle context
 * @param bndId The bundle id to unload.
 * @return true if the bundle is correctly unloaded. False if not.
 */
bool celix_bundleContext_unloadBundle(celix_bundle_context_t* ctx, long bndId);

void celix_bundleContext_cleanup(celix_bundle_context_t* ctx);

#ifdef __cplusplus
}
#endif

#endif /* BUNDLE_CONTEXT_PRIVATE_H_ */