linphone-PresenceServiceImpl文件对应的JNI层文件分析

说明

今天是情人节，今天啥也不想说。

native函数

private native long newPresenceServiceImpl(String id, int status, String contact);
    private native void unref(long nativePtr);
    private native String getId(long nativePtr);
    private native int setId(long nativePtr, String id);
    private native int getBasicStatus(long nativePtr);
    private native int setBasicStatus(long nativePtr, int status);
    private native String getContact(long nativePtr);
    private native int setContact(long nativePtr, String contact);
    private native long getNbNotes(long nativePtr);
    private native Object getNthNote(long nativePtr, long idx);
    private native int addNote(long nativePtr, long notePtr);
    private native int clearNotes(long nativePtr);

具体的函数分析

native long newPresenceServiceImpl(String id, int status, String contact);

/*
 * Class:     org_linphone_core_PresenceServiceImpl
 * Method:    newPresenceServiceImpl
 * Signature: (Ljava/lang/String;ILjava/lang/String;)J
 */
JNIEXPORT jlong JNICALL Java_org_linphone_core_PresenceServiceImpl_newPresenceServiceImpl(JNIEnv *env, jobject jobj, jstring id, jint basic_status, jstring contact) {
    LinphonePresenceService *service;
    const char *cid = id ? env->GetStringUTFChars(id, NULL) : NULL;
    const char *ccontact = contact ? env->GetStringUTFChars(contact, NULL) : NULL;
    service = linphone_presence_service_new(cid, (LinphonePresenceBasicStatus)basic_status, ccontact);
    service = linphone_presence_service_ref(service);
    if (cid) env->ReleaseStringUTFChars(id, cid);
    if (ccontact) env->ReleaseStringUTFChars(contact, ccontact);
    return (jlong)service;
}

LinphonePresenceService

linphone/coreapi/presence.c:struct _LinphonePresenceService {

linphone/coreapi/linphonepresence.h:struct _LinphonePresenceService;

linphone/coreapi/linphonepresence.h:typedef struct _LinphonePresenceService LinphonePresenceService;

struct _LinphonePresenceService {
    void *user_data;
    int refcnt;
    char *id;
    LinphonePresenceBasicStatus status;
    char *contact;
    MSList *notes;              /**< A list of _LinphonePresenceNote structures. */
    time_t timestamp;
};

这个是第一个， 我觉得不是很像。

/**
 * Structure holding the information about a presence service.
 */
struct _LinphonePresenceService;

这个才是真的。

/**
 * Presence service type holding information about a presence service.
 */
typedef struct _LinphonePresenceService LinphonePresenceService;

原来LinphonePresenceService是这个的定义。

找来找去， 才会返现， presence.c还真是最后的实现呢。

linphone_presence_service_new

linphone/coreapi/presence.c:LinphonePresenceService * linphone_presence_service_new(const char *id, LinphonePresenceBasicStatus basic_status, const char *contact) {

linphone/coreapi/linphonepresence.h:LINPHONE_PUBLIC LinphonePresenceService * linphone_presence_service_new(const char *id, LinphonePresenceBasicStatus basic_status, const char *contact);

/*****************************************************************************
 * PRESENCE SERVICE FUNCTIONS TO GET ACCESS TO ALL FUNCTIONALITIES           *
 ****************************************************************************/

LinphonePresenceService * linphone_presence_service_new(const char *id, LinphonePresenceBasicStatus basic_status, const char *contact) {
    LinphonePresenceService *service;
    char *service_id;
    if (id == NULL)
        service_id = generate_presence_id();
    else
        service_id = ms_strdup(id);
    service = presence_service_new(service_id, basic_status);
    linphone_presence_service_set_contact(service, contact);
    if (service_id != NULL)
        ms_free(service_id);
    return service;
}

generate_presence_id

linphone/coreapi/presence.c:static char * generate_presence_id(void) {

static char * generate_presence_id(void) {
    char id[7];
    int i;
    id[0] = presence_id_valid_start_characters[ortp_random() % (sizeof(presence_id_valid_start_characters)-1)];
    for (i = 1; i < 6; i++) {
        id[i] = presence_id_valid_characters[ortp_random() % (sizeof(presence_id_valid_characters)-1)];
    }
    id[6] = '\0';

    return ms_strdup(id);
}

presence_id_valid_start_characters

static char presence_id_valid_start_characters[] = ":_abcdefghijklmnopqrstuvwxyz";

presence_service_new

static LinphonePresenceService * presence_service_new(const char *id, LinphonePresenceBasicStatus status) {
    LinphonePresenceService *service = ms_new0(LinphonePresenceService, 1);
    service->refcnt = 1;
    if (id != NULL) {
        service->id = ms_strdup(id);
    }
    service->status = status;
    service->timestamp = time(NULL);
    return service;
}

linphone_presence_service_set_contact

int linphone_presence_service_set_contact(LinphonePresenceService *service, const char *contact) {
    if (service == NULL) return -1;
    if (service->contact != NULL)
        ms_free(service->contact);
    if (contact != NULL)
        service->contact = ms_strdup(contact);
    else
        service->contact = NULL;
    return 0;
}

linphone_presence_service_ref

LinphonePresenceService * linphone_presence_service_ref(LinphonePresenceService *service) {
    service->refcnt++;
    return service;
}

LinphonePresenceBasicStatus

linphone/coreapi/linphonepresence.h:typedef enum LinphonePresenceBasicStatus {

/** Basic status as defined in section 4.1.4 of RFC 3863 */
typedef enum LinphonePresenceBasicStatus {
    /** This value means that the associated contact element, if any, is ready to accept communication. */
    LinphonePresenceBasicStatusOpen,

    /** This value means that the associated contact element, if any, is unable to accept communication. */
    LinphonePresenceBasicStatusClosed
} LinphonePresenceBasicStatus;

这个状态其实就是一个枚举。

native void unref(long nativePtr);

JNIEXPORT void JNICALL Java_org_linphone_core_PresenceServiceImpl_unref(JNIEnv *env, jobject jobj, jlong ptr) {
    LinphonePresenceService *service = (LinphonePresenceService *)ptr;
    linphone_presence_service_unref(service);
}

linphone_presence_service_unref

linphone/coreapi/linphonepresence.h:LINPHONE_PUBLIC LinphonePresenceService * linphone_presence_service_unref(LinphonePresenceService *service);

linphone/coreapi/presence.c:LinphonePresenceService * linphone_presence_service_unref(LinphonePresenceService *service) {

LinphonePresenceService * linphone_presence_service_unref(LinphonePresenceService *service) {
    service->refcnt--;
    if (service->refcnt == 0) {
        presence_service_delete(service);
        return NULL;
    }
    return service;
}

presence_service_delete

static void presence_service_delete(LinphonePresenceService *service) {
    if (service->id != NULL) {
        ms_free(service->id);
    }
    if (service->contact != NULL) {
        ms_free(service->contact);
    }
    ms_list_for_each(service->notes, (MSIterateFunc)linphone_presence_note_unref);
    ms_list_free(service->notes);
    ms_free(service);
};

native String getId(long nativePtr);

/*
 * Class:     org_linphone_core_PresenceServiceImpl
 * Method:    getId
 * Signature: (J)Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_org_linphone_core_PresenceServiceImpl_getId(JNIEnv *env, jobject jobj, jlong ptr) {
    LinphonePresenceService *service = (LinphonePresenceService *)ptr;
    char *cid = linphone_presence_service_get_id(service);
    jstring jid = cid ? env->NewStringUTF(cid) : NULL;
    if (cid) ms_free(cid);
    return jid;
}

linphone_presence_service_get_id

char * linphone_presence_service_get_id(const LinphonePresenceService *service) {
    if (service == NULL) return NULL;
    return ms_strdup(service->id);
}

native int setId(long nativePtr, String id);

/*
 * Class:     org_linphone_core_PresenceServiceImpl
 * Method:    setId
 * Signature: (JLjava/lang/String;)I
 */
JNIEXPORT jint JNICALL Java_org_linphone_core_PresenceServiceImpl_setId(JNIEnv *env, jobject jobj, jlong ptr, jstring id) {
    LinphonePresenceService *service = (LinphonePresenceService *)ptr;
    const char *cid = id ? env->GetStringUTFChars(id, NULL) : NULL;
    linphone_presence_service_set_id(service, cid);
    if (cid) env->ReleaseStringUTFChars(id, cid);
    return (jint)0;
}

linphone_presence_service_set_id

int linphone_presence_service_set_id(LinphonePresenceService *service, const char *id) {
    if (service == NULL) return -1;
    if (service->id != NULL)
        ms_free(service->id);
    if (id == NULL)
        service->id = generate_presence_id();
    else
        service->id = ms_strdup(id);
    return 0;
}

native int getBasicStatus(long nativePtr);

/*
 * Class:     org_linphone_core_PresenceServiceImpl
 * Method:    getBasicStatus
 * Signature: (J)I
 */
JNIEXPORT jint JNICALL Java_org_linphone_core_PresenceServiceImpl_getBasicStatus(JNIEnv *env, jobject jobj, jlong ptr) {
    LinphonePresenceService *service = (LinphonePresenceService *)ptr;
    return (jint)linphone_presence_service_get_basic_status(service);
}

linphone_presence_service_get_basic_status

LinphonePresenceBasicStatus linphone_presence_service_get_basic_status(const LinphonePresenceService *service) {
    if (service == NULL) return LinphonePresenceBasicStatusClosed;
    return service->status;
}

native int setBasicStatus(long nativePtr, int status);

/*
 * Class:     org_linphone_core_PresenceServiceImpl
 * Method:    setBasicStatus
 * Signature: (JI)I
 */
JNIEXPORT jint JNICALL Java_org_linphone_core_PresenceServiceImpl_setBasicStatus(JNIEnv *env, jobject jobj, jlong ptr, jint basic_status) {
    LinphonePresenceService *service = (LinphonePresenceService *)ptr;
    return (jint)linphone_presence_service_set_basic_status(service, (LinphonePresenceBasicStatus)basic_status);
}

linphone_presence_service_set_basic_status

int linphone_presence_service_set_basic_status(LinphonePresenceService *service, LinphonePresenceBasicStatus basic_status) {
    if (service == NULL) return -1;
    service->status = basic_status;
    return 0;
}

native String getContact(long nativePtr);

/*
 * Class:     org_linphone_core_PresenceServiceImpl
 * Method:    getContact
 * Signature: (J)Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_org_linphone_core_PresenceServiceImpl_getContact(JNIEnv *env, jobject jobj, jlong ptr) {
    LinphonePresenceService *service = (LinphonePresenceService *)ptr;
    char *ccontact = linphone_presence_service_get_contact(service);
    jstring jcontact = ccontact ? env->NewStringUTF(ccontact) : NULL;
    if (ccontact) ms_free(ccontact);
    return jcontact;
}

linphone_presence_service_get_contact

char * linphone_presence_service_get_contact(const LinphonePresenceService *service) {
    if (service->contact == NULL) return NULL;
    return ms_strdup(service->contact);
}

native int setContact(long nativePtr, String contact);

/*
 * Class:     org_linphone_core_PresenceServiceImpl
 * Method:    setContact
 * Signature: (JLjava/lang/String;)I
 */
JNIEXPORT jint JNICALL Java_org_linphone_core_PresenceServiceImpl_setContact(JNIEnv *env, jobject jobj, jlong ptr, jstring contact) {
    LinphonePresenceService *service = (LinphonePresenceService *)ptr;
    const char *ccontact = contact ? env->GetStringUTFChars(contact, NULL) : NULL;
    linphone_presence_service_set_contact(service, ccontact);
    if (ccontact) env->ReleaseStringUTFChars(contact, ccontact);
    return (jint)0;
}

linphone_presence_service_set_contact

int linphone_presence_service_set_contact(LinphonePresenceService *service, const char *contact) {
    if (service == NULL) return -1;
    if (service->contact != NULL)
        ms_free(service->contact);
    if (contact != NULL)
        service->contact = ms_strdup(contact);
    else
        service->contact = NULL;
    return 0;
}

native long getNbNotes(long nativePtr);

/*
 * Class:     org_linphone_core_PresenceServiceImpl
 * Method:    getNbNotes
 * Signature: (J)J
 */
JNIEXPORT jlong JNICALL Java_org_linphone_core_PresenceServiceImpl_getNbNotes(JNIEnv *env, jobject jobj, jlong ptr) {
    LinphonePresenceService *service = (LinphonePresenceService *)ptr;
    return (jlong)linphone_presence_service_get_nb_notes(service);
}

linphone_presence_service_get_nb_notes

unsigned int linphone_presence_service_get_nb_notes(const LinphonePresenceService *service) {
    return ms_list_size(service->notes);
}

native Object getNthNote(long nativePtr, long idx);

/*
 * Class:     org_linphone_core_PresenceServiceImpl
 * Method:    getNthNote
 * Signature: (JJ)Ljava/lang/Object;
 */
JNIEXPORT jobject JNICALL Java_org_linphone_core_PresenceServiceImpl_getNthNote(JNIEnv *env, jobject jobj, jlong ptr, jlong idx) {
    LinphonePresenceService *service = (LinphonePresenceService *)ptr;
    LinphonePresenceNote *note = linphone_presence_service_get_nth_note(service, (unsigned int)idx);
    if (note == NULL) return NULL;
    RETURN_USER_DATA_OBJECT("PresenceNoteImpl", linphone_presence_note, note)
}

linphone_presence_service_get_nth_note

LinphonePresenceNote * linphone_presence_service_get_nth_note(const LinphonePresenceService *service, unsigned int idx) {
    if ((service == NULL) || (idx >= linphone_presence_service_get_nb_notes(service)))
        return NULL;

    return (LinphonePresenceNote *)ms_list_nth_data(service->notes, idx);
}

ms_list_nth_data

linphone/mediastreamer2/include/mediastreamer2/mscommon.h:MS2_PUBLIC void * ms_list_nth_data(const MSList *list, int index);

linphone/mediastreamer2/src/base/mscommon.c:void * ms_list_nth_data(const MSList *list, int index){

RETURN_USER_DATA_OBJECT

linphone/coreapi/linphonecore_jni.cc:#define RETURN_USER_DATA_OBJECT(javaclass, funcprefix, cobj) \

#define RETURN_USER_DATA_OBJECT(javaclass, funcprefix, cobj) \
    { \
        jclass jUserDataObjectClass; \
        jmethodID jUserDataObjectCtor; \
        jobject jUserDataObj; \
        jUserDataObj = (jobject)funcprefix ## _get_user_data(cobj); \
        if (jUserDataObj == NULL) { \
            jUserDataObjectClass = (jclass)env->NewGlobalRef(env->FindClass("org/linphone/core/" javaclass)); \
            jUserDataObjectCtor = env->GetMethodID(jUserDataObjectClass,"<init>", "(J)V"); \
            jUserDataObj = env->NewObject(jUserDataObjectClass, jUserDataObjectCtor, (jlong)funcprefix ## _ref(cobj)); \
            jUserDataObj = env->NewGlobalRef(jUserDataObj); \
            funcprefix ## _set_user_data(cobj, jUserDataObj); \
            env->DeleteGlobalRef(jUserDataObjectClass); \
        } \
        return jUserDataObj; \
    }

native int addNote(long nativePtr, long notePtr);

/*
 * Class:     org_linphone_core_PresenceModelImpl
 * Method:    addNote
 * Signature: (JLjava/lang/String;Ljava/lang/String;)I
 */
JNIEXPORT jint JNICALL Java_org_linphone_core_PresenceModelImpl_addNote(JNIEnv *env, jobject jobj, jlong ptr, jstring description, jstring lang) {
    LinphonePresenceModel *model = (LinphonePresenceModel *)ptr;
    const char *cdescription = description ? env->GetStringUTFChars(description, NULL) : NULL;
    const char *clang = lang ? env->GetStringUTFChars(lang, NULL) : NULL;
    jint res = (jint)linphone_presence_model_add_note(model, cdescription, clang);
    if (cdescription) env->ReleaseStringUTFChars(description, cdescription);
    if (clang) env->ReleaseStringUTFChars(lang, clang);
    return res;
}

linphone_presence_model_add_note

int linphone_presence_model_add_note(LinphonePresenceModel *model, const char *note_content, const char *lang) {
    LinphonePresenceService *service;
    LinphonePresenceNote *note;

    if ((model == NULL) || (note_content == NULL))
        return -1;

    /* Will put the note in the first service. */
    service = ms_list_nth_data(model->services, 0);
    if (service == NULL) {
        /* If no service exists, create one. */
        service = presence_service_new(generate_presence_id(), LinphonePresenceBasicStatusClosed);
    }
    if (service == NULL)
        return -1;

    /* Search for an existing note in the specified language. */
    note = find_presence_note_in_list(service->notes, lang);
    if (note == NULL) {
        note = linphone_presence_note_new(note_content, lang);
    } else {
        linphone_presence_note_set_content(note, note_content);
    }
    if (note == NULL)
        return -1;

    presence_service_add_note(service, note);

    return 0;
}

LinphonePresenceModel

linphone/coreapi/presence.c:struct _LinphonePresenceModel {

linphone/coreapi/linphonepresence.h:struct _LinphonePresenceModel;

linphone/coreapi/linphonepresence.h:typedef struct _LinphonePresenceModel LinphonePresenceModel;

/**
 * Represents the presence model as defined in RFC 4479 and RFC 4480.
 * This model is not complete. For example, it does not handle devices.
 */
struct _LinphonePresenceModel {
    LinphoneAddress *presentity; /* "The model seeks to describe the presentity, identified by a presentity URI.*/
    void *user_data;
    int refcnt;
    MSList *services;   /**< A list of _LinphonePresenceService structures. Also named tuples in the RFC. */
    MSList *persons;    /**< A list of _LinphonePresencePerson structures. */
    MSList *notes;      /**< A list of _LinphonePresenceNote structures. */
};

LinphonePresenceNote

linphone/coreapi/presence.c:struct _LinphonePresenceNote {

struct _LinphonePresenceNote {
    void *user_data;
    int refcnt;
    char *lang;
    char *content;
};

presence_service_new

static LinphonePresenceService * presence_service_new(const char *id, LinphonePresenceBasicStatus status) {
    LinphonePresenceService *service = ms_new0(LinphonePresenceService, 1);
    service->refcnt = 1;
    if (id != NULL) {
        service->id = ms_strdup(id);
    }
    service->status = status;
    service->timestamp = time(NULL);
    return service;
}

find_presence_note_in_list

linphone/coreapi/presence.c:static LinphonePresenceNote * find_presence_note_in_list(MSList *list, const char *lang) {

static LinphonePresenceNote * find_presence_note_in_list(MSList *list, const char *lang) {
    int nb;
    int i;

    nb = ms_list_size(list);
    for (i = 0; i < nb; i++) {
        LinphonePresenceNote *note = (LinphonePresenceNote *)ms_list_nth_data(list, i);
        if (lang == NULL) {
            if (note->lang == NULL) {
                return note;
            }
        } else {
            if ((note->lang != NULL) && (strcmp(lang, note->lang) == 0)) {
                return note;
            }
        }
    }

    return NULL;
}

linphone_presence_note_new

/*****************************************************************************
 * PRESENCE NOTE FUNCTIONS TO GET ACCESS TO ALL FUNCTIONALITIES              *
 ****************************************************************************/

LinphonePresenceNote * linphone_presence_note_new(const char *content, const char *lang) {
    LinphonePresenceNote *note;

    if (content == NULL) return NULL;
    note = ms_new0(LinphonePresenceNote, 1);
    note->refcnt = 1;
    note->content = ms_strdup(content);
    if (lang != NULL) {
        note->lang = ms_strdup(lang);
    }
    return note;
}

linphone_presence_note_set_content

int linphone_presence_note_set_content(LinphonePresenceNote *note, const char *content) {
    if (content == NULL) return -1;
    if (note->content != NULL) {
        ms_free(note->content);
    }
    note->content = ms_strdup(content);
    return 0;
}

native int clearNotes(long nativePtr);

/*
 * Class:     org_linphone_core_PresenceModelImpl
 * Method:    clearNotes
 * Signature: (J)I
 */
JNIEXPORT jint JNICALL Java_org_linphone_core_PresenceModelImpl_clearNotes(JNIEnv *env, jobject jobj, jlong ptr) {
    LinphonePresenceModel *model = (LinphonePresenceModel *)ptr;
    return (jint)linphone_presence_model_clear_notes(model);
}

linphone_presence_model_clear_notes

linphone/coreapi/presence.c:int linphone_presence_model_clear_notes(LinphonePresenceModel *model) {

linphone/coreapi/linphonepresence.h:LINPHONE_PUBLIC int linphone_presence_model_clear_notes(LinphonePresenceModel *model);

int linphone_presence_model_clear_notes(LinphonePresenceModel *model) {
    if (model == NULL)
        return -1;

    ms_list_for_each(model->persons, (MSIterateFunc)clear_presence_person_notes);
    ms_list_for_each(model->services, (MSIterateFunc)clear_presence_service_notes);
    ms_list_for_each(model->notes, (MSIterateFunc)linphone_presence_note_unref);
    ms_list_free(model->notes);
    model->notes = NULL;

    return 0;
}

ms_list_for_each

linphone/mediastreamer2/src/base/mscommon.c:void ms_list_for_each(const MSList *list, void (*func)(void *)){

linphone/mediastreamer2/include/mediastreamer2/mscommon.h:MS2_PUBLIC void ms_list_for_each(const MSList *list, MSIterateFunc iterate_func);
linphone/mediastreamer2/include/mediastreamer2/mscommon.h:MS2_PUBLIC void ms_list_for_each2(const MSList *list, MSIterate2Func iterate_func, void *user_data);
linphone/mediastreamer2/include/mediastreamer2/mscommon.h:MS2_PUBLIC void ms_list_for_each3(const MSList *list, MSIterate3Func iterate_func, void *user_data, void *factory);

void ms_list_for_each(const MSList *list, void (*func)(void *)){
    for(;list!=NULL;list=list->next){
        func(list->data);
    }
}

void ms_list_for_each2(const MSList *list, void (*func)(void *, void *y), void *user_data){
    for(;list!=NULL;list=list->next){
        func(list->data,user_data);
    }
}

void ms_list_for_each3(const MSList *list, void (*func)(void *, void *, void*), void *user_data, void* factory){
    for(;list!=NULL;list=list->next){
        func(list->data,user_data, factory);
    }
}