EasyDarwin 구현 설명 추가 모듈

Darwin의 구조에서 중요한 개념 중 하나는 모듈(Module)이다. 우리는 원생 Darwin 시스템에 두 개의 모듈(Module)을 추가했다. 이것은 MyBCInteractModule과 MyFileUploadModule이다. 각 모듈은 두 개의 함수를 제공해야 한다. Main과dispatch 함수, 서버가 시작될 때(QTSServer)는 Main 함수를 호출하여 이 모듈에 대한 초기화를 완성한다.Dispatch는 서버에 등록된 콜백 함수입니다. 서버는 이 함수를 통해 이 모듈에서 구독하는 다양한 역할을 나누어 줍니다. 이러한 역할은 다음과 같이 정의됩니다.

/********************************************************************/
// QTSS API ROLES
//
// Each role represents a unique situation in which a module may be
// invoked. Modules must specify which roles they want to be invoked for. 
enum
{
    //Global
    QTSS_Register_Role =             FOUR_CHARS_TO_INT('r', 'e', 'g', ' '), //reg  //All modules get this once at startup
    QTSS_Initialize_Role =           FOUR_CHARS_TO_INT('i', 'n', 'i', 't'), //init //Gets called once, later on in the startup process
    QTSS_Shutdown_Role =             FOUR_CHARS_TO_INT('s', 'h', 'u', 't'), //shut //Gets called once at shutdown
    
    QTSS_ErrorLog_Role =             FOUR_CHARS_TO_INT('e', 'l', 'o', 'g'), //elog //This gets called when the server wants to log an error.
    QTSS_RereadPrefs_Role =          FOUR_CHARS_TO_INT('p', 'r', 'e', 'f'), //pref //This gets called when the server rereads preferences.
    QTSS_StateChange_Role =          FOUR_CHARS_TO_INT('s', 't', 'a', 't'), //stat //This gets called whenever the server changes state.
    
    QTSS_Interval_Role =             FOUR_CHARS_TO_INT('t', 'i', 'm', 'r'), //timr //This gets called whenever the module's interval timer times out calls.
    
    //RTSP-specific
    QTSS_RTSPFilter_Role =           FOUR_CHARS_TO_INT('f', 'i', 'l', 't'), //filt //Filter all RTSP requests before the server parses them
    QTSS_RTSPRoute_Role =            FOUR_CHARS_TO_INT('r', 'o', 'u', 't'), //rout //Route all RTSP requests to the correct root folder.
    QTSS_RTSPAuthenticate_Role =     FOUR_CHARS_TO_INT('a', 't', 'h', 'n'), //athn //Authenticate the RTSP request username.
    QTSS_RTSPAuthorize_Role =        FOUR_CHARS_TO_INT('a', 'u', 't', 'h'), //auth //Authorize RTSP requests to proceed
    QTSS_RTSPPreProcessor_Role =     FOUR_CHARS_TO_INT('p', 'r', 'e', 'p'), //prep //Pre-process all RTSP requests before the server responds.
                                        //Modules may opt to "steal" the request and return a client response.
    QTSS_RTSPRequest_Role =          FOUR_CHARS_TO_INT('r', 'e', 'q', 'u'), //requ //Process an RTSP request & send client response
    QTSS_RTSPPostProcessor_Role =    FOUR_CHARS_TO_INT('p', 'o', 's', 't'), //post //Post-process all RTSP requests
    QTSS_RTSPSessionClosing_Role =   FOUR_CHARS_TO_INT('s', 'e', 's', 'c'), //sesc //RTSP session is going away
    QTSS_RTSPIncomingData_Role =     FOUR_CHARS_TO_INT('i', 'c', 'm', 'd'), //icmd //Incoming interleaved RTP data on this RTSP connection
    //RTP-specific
    QTSS_RTPSendPackets_Role =          FOUR_CHARS_TO_INT('s', 'e', 'n', 'd'), //send //Send RTP packets to the client
    QTSS_ClientSessionClosing_Role =    FOUR_CHARS_TO_INT('d', 'e', 's', 's'), //dess //Client session is going away
    
    //RTCP-specific
    QTSS_RTCPProcess_Role =             FOUR_CHARS_TO_INT('r', 't', 'c', 'p'), //rtcp //Process all RTCP packets sent to the server
    //File system roles
    QTSS_OpenFilePreProcess_Role =      FOUR_CHARS_TO_INT('o', 'p', 'p', 'r'),  //oppr
    QTSS_OpenFile_Role =                FOUR_CHARS_TO_INT('o', 'p', 'f', 'l'),  //opfl
    QTSS_AdviseFile_Role =              FOUR_CHARS_TO_INT('a', 'd', 'f', 'l'),  //adfl
    QTSS_ReadFile_Role =                FOUR_CHARS_TO_INT('r', 'd', 'f', 'l'),  //rdfl
    QTSS_CloseFile_Role =               FOUR_CHARS_TO_INT('c', 'l', 'f', 'l'),  //clfl
    QTSS_RequestEventFile_Role =        FOUR_CHARS_TO_INT('r', 'e', 'f', 'l'),  //refl
    //HLS Session
    Easy_HLSOpen_Role   =               FOUR_CHARS_TO_INT('h', 'l', 's', 'o'),  //hlso
    Easy_HLSClose_Role  =               FOUR_CHARS_TO_INT('h', 'l', 's', 'c'),  //hlsc
    
};
typedef UInt32 QTSS_Role;

각 모듈의 main은 다음과 같습니다.

QTSS_Error MyBCInteractModule_Main(void* inPrivateArgs)
{
    return _stublibrary_main(inPrivateArgs, MyBCInteractModuleDispatch);
}

여기서 MyBCInteractModuleDispatch는 Dispatch 함수로서 다음과 같은 다양한 역할에 대한 처리를 담당합니다.

QTSS_Error  MyBCInteractModuleDispatch(QTSS_Role inRole, QTSS_RoleParamPtr inParams)
{
    switch (inRole)
    {
        case QTSS_Register_Role:
            return Register(&inParams->regParams);
        break;
        
        case QTSS_Initialize_Role:
            return Initialize(&inParams->initParams);
        break;
        
        case QTSS_RereadPrefs_Role:
            return RereadPrefs();
        break;
        case QTSS_RTSPAuthenticate_Role:
                return AuthenticateRTSPRequest(&inParams->rtspAthnParams);
        break;
        
        case QTSS_RTSPAuthorize_Role:
                return AccessAuthorizeRTSPRequest(&inParams->rtspRequestParams);
        break;
            
        case QTSS_Shutdown_Role:
            return Shutdown();
        break;
    }
    
    return QTSS_NoErr;
}

그럼 MyBCInteractModule 및!My File Upload Module은 언제 Darwin 시스템에 등록되었습니까?정답은 QTSServer::LoadCompiled InModules, 호출 중!SetupModule에서는 모듈의 Main 함수를 전송하고, SetupModule에서는 이 main 함수를 호출하여 이 모듈의 dispatch 함수를 가져옵니다. AddModule에서는 dispatch 함수를 호출하여 QTSS_Register_Role 역할, 이때 MyBCInteractModule과 MyFileUploadModule는 자신이 관심 있는 역할을 추가합니다. 마지막으로AddModule에서 MyBCInteractModule와 MyFileUploadModule를 대기열에 추가합니다.여기까지, 모듈을 추가하면 완성된 셈이다.

void    QTSServer::LoadCompiledInModules()
{
#ifndef DSS_DYNAMIC_MODULES_ONLY
    //
    // The following modules are all compiled into the server. 
    
    QTSSModule* theFileModule = new QTSSModule("QTSSFileModule");
    (void)theFileModule->SetupModule(&sCallbacks, &QTSSFileModule_Main);
    (void)AddModule(theFileModule);
    // 
    QTSSModule* theBCInteractModule = new QTSSModule("MyBCInteractModule");
    (void)theBCInteractModule->SetupModule(&sCallbacks, &MyBCInteractModule_Main);
    (void)AddModule(theBCInteractModule);
    
    //   
    QTSSModule* theFileUploadModule = new QTSSModule("MyFileUploadModule");
    (void)theFileUploadModule->SetupModule(&sCallbacks, &MyFileUploadModule_Main);
    (void)AddModule(theFileUploadModule);
    xxxxxx
}

기술 교류는 QQ군[554271674]에 들어갈 수 있다