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);    }}