&MCOP;: objektmodel og strømme
Oversigt
&MCOP; er standarden som &arts; anvender til:
Kommunikation mellem objekter.
Netværkstransparens.
Beskrivelse af objektgrænseflader.
Sproguafhængighed.
En vigtig del af &MCOP; er grænsefladesbeskrivelsessproget, &IDL;, som bruges til at definere mange af &arts; programmeringsgrænseflader og andre grænseflader på en sproguafhængig måde.
For at bruge en &IDL;-grænseflade fra C++, kompileres den med &IDL; oversætteren til C++ kode. Når du implementerer en grænseflade, afleder du fra skabelonklassen som &IDL; oversætteren har oprettet. Når man bruger en grænseflade gør man det med en omliggende skal. På denne måde kan &MCOP; bruge en protokol hvis objektet du taler med ikke er lokalt - man får netværkstransparens.
I dette kapitel er emnet at beskrive de grundlæggende funktioner i objektmodellen som er resultatet af at bruge &MCOP;, protokollen, hvordan &MCOP; bruges med C++ (sprogbindning), og så videre.
Grænseflade og &IDL;
Meget af den service som varetages af &arts;, såsom modulerne og lydserveren defineres i form af grænseflader. Grænseflader specificeres i et programsprogsuafhængig format: &IDL;.
Dette tillader at mange af implementeringsdetaljerne såsom formatet på multimediadatastrømmene, netværkstransparens og programsprogsuafhængig skjules for specifikationen af grænsefladen. Et værktøj, &mcopidl;, oversætter grænsefladedefinitionen til et specifikt programmeringssprog (for øjeblikket understøttes kun C++).
Værktøjet laver en skeletklasse med al standardkode og grundlæggende funktionalitet. Man afleder fra denne klassen for at implementere de funktioner man vil have.
Det &IDL; som bruges af &arts; ligner det som bruges af CORBA og DCOM.
&IDL;-filer kan indholde:
C-stil #include-direktiv for andre &IDL;-filer.
Definitioner af nummereringstyper og struct-typer, som i C/C++.
Definitioner af grænseflade.
I &IDL; defineres grænseflade på en måde som minder meget om en C++ klasse eller C-struct, dog med visse begrænsninger. Som i C++, så kan grænseflader være underklasser til andre grænseflader med arv. Grænsefladedefinitioner kan indeholde tre ting: Strømme, egenskaber og metoder.
Strømme
Strømme definerer multimediadata, en af de vigtigste komponenter i et modul. Strømme defineres med følgende format:
[ async ] in|out [ multi ] typ stream navn [ , navn ] ;
Strømme har en defineret retning i forhold til modulet, som angives af de nødvendige parametre in eller out. Typeargumentet definerer datatypen, som kan være en hvilken som helst af typerne for egenskaber som beskrives senere (ikke alle understøttes endnu). Mange moduler bruger strømtypen audio, som er et alias for float eftersom det er det interne dataformatet for lydstrømme. Flere strømme af samme type kan indgå i samme definition med navne adskilt med kommategn.
Strømme er normalt synkrone, hvilket betyder at de er kontinuerlige dataflows med en konstant hastighed, såsom PCM-lyd. Parameteren async angiver en asynkron strøm, som bruges til ikke-kontinuerlige datastrømme. Det almindeligste eksempel på en asynkron strøm er &MIDI;-meddelelser.
Nøgleordet multi, som kun er gyldigt for inddatastrømme, angiver at grænsefladen understøtter et variabelt antal indgange. Dette er nyttigt til at implementere enheder såsom en mixer som kan tage imod et hvilket som helst antal inddatastrømme.
Attributter
Attributter er data som hører sammen med en udgave af en grænseflade. De deklareres som medlemsvariabler i C++, og kan bruges af en hvilken som helst af de primitive typer boolean, byte, long, string, eller float. Du kan også bruge selvdefinerede struct- eller nummereringstyper samt sekvenser af variabel størrelse med syntaksen sekvens<type>. Attributter kan valgfrit markeres som skrivebeskyttede.
Metoder
Som i C++, kan metoder defineres i grænseflader. Metodeparametrene er begrænsede til samme typer som attributterne. Nøgleordet oneway angiver en metode som returnerer umiddelbart og køres asynkront.
Standardgrænseflader
Flere grænseflader for standardmoduler er allerede definerede for dig i &arts;, såsom StereoEffect, og SimpleSoundServer.
Eksempel
Et enkelt eksempel på et modul taget fra &arts; er modulet med konstant forsinkelse, som findes i filen kdemultimedia/arts/modules/artsmodules.idl. Grænsefladedefinitionen angives nedenfor:
interface Synth_CDELAY : SynthModule {
attribute float time;
in audio stream invalue;
out audio stream outvalue;
};
Modulet arver SynthModule. Den grænseflade, som findes i artsflow.idl, definerer alle standardmetoder som implementeres i alle syntesemoduler.
CDELAY-effekten forsinker en stereolydstrøm med tidsværdien som angives som en decimaltal parameter. Grænsefladedefinitionen har en attribut af typen float til at opbevare forsinkelsesværdien. Den definerer to inddata- og to uddatastrømme (typisk for stereoeffekter). Ingen metoder kræves ud over de arvede.
Mere om strømme
Dette afsnit dækker en del yderligere emneområder som hører sammen med strømme.
Strømtyper
Der er forskellige krav for hvordan et modul kan håndtere strømningen. For at illustrere dette, betragt følgende eksempel:
Skalering af et signal med en faktor to.
Udfører frekvenskonvertering af samplinger.
Dekomprimering af et runlength-kodet signal.
Læs &MIDI;-begivenheder fra /dev/midi00 og indsæt dem i en strøm.
Det første tilfælde er det enkleste: når modulet modtager 200 inddatasamplinger producerer det 200 uddatasamplinger. Det producerer kun uddata når det får inddata.
Det andet tilfælde producerer forskellige antal uddatasamplinger når det får 200 inddatasamplinger. Det afhænger af hvilken konvertering som udføres, men antallet er kendt i forvejen.
Det tredje tilfælde er endnu værre. Fra begyndelsen kan man ikke engang gætte hvor meget data som laves af 200 inddata byte (formodentlig meget mere end 200 byte, men...).
Det sidste tilfælde er et modul som aktiveres af sig selv, og sommetider laver data.
I &arts;-0.3.4, håndteredes kun strømme af den første type, og de fleste ting virkede godt. Dette er formodentlig hvad du mest behøver når du skriver moduler som behandler lyd. Problemerne med de andre, mere komplekse slags strømme er, at de er svære at programmere, og at man for det meste ikke behøver funktionerne. Dette er grunden til at vi gør dette med to forskellige slags strømtyper: synkrone og asynkrone.
Synkrone strømme har følgende egenskaber:
Moduler skal kunne beregne data af en hvilken som helst længde, givet tilstrækkelig meget inddata.
Alle strømme har samme samplingsrate.
Funktionen calculateBlock() kaldes når tilstrækkeligt med data er tilgængelig, og modulet kan stole på at pegerne angiver data.
Der er ingen allokering eller afallokering der skal gøres.
Asynkrone strømme, på den anden side, opfører sig sådan her:
Moduler kan producere data ind imellem, eller med varierende samplingsfrekvens, eller kun hvis de får inddata fra en fil. De skal ikke følge reglen skal kunne håndtere forespørgsler af en hvilken som helst størrelse
.
Asynkrone strømme for et modul kan have helt forskellige samplingsrater.
Udgående strømme: der er særlige funktioner til at allokere pakker, til at sende pakker - og en valgfri mekanisme til at spørge efter data som fortæller når mere data skal laves.
Indkommende strømme: et kald sendes når en ny pakke modtages. Man skal fortælle når man er færdig med at behandle al data i den pakke, og dette må ikke ske med det samme (man kan fortælle om det når som helst senere, og hvis alle har behandlet en pakke, bliver den frigjort/genbrugt).
Når strømme deklareres, bruges nøgleordet async
til at angive at strømmen skal være asynkron. Så antag for eksempel at du vil konvertere en asynkron strøm af byte til en synkron strøm af samplinger. Grænsefladen ville så kunne se sådan her ud:
interface ByteStreamToAudio : SynthModule {
async in byte stream inddata; // den asynkrone inddatasampling
out audio stream left,right; // de synkrone uddatasamplinger
};
Brug af asynkrone strømme
Antag at du har bestemt dig for at skrive et modul som laver asynkron lyd. Dens grænseflade kunne se sådan her ud:
interface SomeModule : SynthModule
{
async out byte stream outdata;
};
Hvordan sender man data? Den første metode kaldes trykleverance
. Med asynkrone strømme sender man data som pakker. Det betyder at individuelle pakker sendes som i eksemplet ovenfor. Den virkelige proces er: allokér en pakke, fyld den, send den.
Her følger det i form af kode. Først allokerer vi en pakke:
DataPacket<mcopbyte> *packet = outdata.allocPacket(100);
Så fylder vi den:
// typekonvertering så fgets får en (char *) peger
char *data = (char *)packet->contents;
// som du ser, kan du krympe pakkestørrelsen efter allokeringen
// hvis du vil
if(fgets(data,100,stdin))
packet->size = strlen(data);
else
packet->size = 0;
Nu sender vi den:
packet->send();
Dette er meget enkelt, men hvis vi vil sende pakker nøjagtigt så hurtigt som modtageren kan håndtere dem, behøves en anden måde, metoden med trækleverance
. Man beder om at sende pakker så hurtigt som modtageren er klar til at behandle dem. Man begynder med en vis mængde pakker som sendes. Mens modtageren behandler pakke efter pakke, begynder man at fylde dem igen med friske data, og sende dem igen.
Du starter det ved at kalde setPull. For eksempel:
outdata.setPull(8, 1024);
Dette betyder at du vil sende pakke via uddata. Du vil begynde med at sende 8 pakker på én gang, og når modtageren behandler nogle af dem, vil du fylde dem op igen.
Derefter behøver du at implementere en metode som fylder pakken, som kunne se sådan her ud:
void request_outdata(DataPacket<mcopbyte> *packet)
{
packet->size = 1024; // skal ikke være mere end 1024
for(int i = 0;i < 1024; i++)
packet->contents[i] = (mcopbyte)'A';
packet->send();
}
Det er alt. Når du ikke har flere data, kan du begynde at sende pakker med størrelsen nul, som stopper trækleverancerne.
Bemærk at det er væsentligt at give metoden nøjagtigt navnet request_strømnavn.
Vi beskrev netop at sende data. At modtage data er meget enklere. Antag at du har et enkelt filter, ToLower, som helt enkelt konverterer alle bogstaver til små:
interface ToLower {
async in byte stream inddata;
async out byte stream uddata;
};
Dette er virkeligt enkelt at implementere. Her er hele implementationen:
class ToLower_impl : public ToLower_skel {
public:
void process_inddata(DataPacket<mcopbyte> *inpacket)
{
DataPacket<mcopbyte> *outpacket = ouddata.allocPacket(inpacket->size);
// lav om til små bogstaver
char *instring = (char *)inpacket->contents;
char *outstring = (char *)outpacket->contents;
for(int i=0;i<inpacket->size;i++)
outstring[i] = tolower(instring[i]);
inpacket->processed();
outpacket->send();
}
};
REGISTER_IMPLEMENTATION(ToLower_impl);
Igen er det væsentligt at give metoden navnet process_strømnavn.
Som du kan se, så får du et kald til en funktion for hver pakke som ankommer (process_indata i vort tilfælde). Du skal kalde metoden processed() for en pakke for at angive at du har behandlet den.
Her er et implementeringstip: Hvis det tager lang tid at behandle data (dvs. hvis du skal vente på udskrift til lydkortet eller noget sådant), så kald ikke processed med det samme, men opbevar hele datapakken og kald kun processed når du virkelig har behandlet pakken. På denne måde, har afsenderne en chance for at vide hvor lang tid det virkelig tager at udføre arbejdet.
Eftersom synkronisering ikke er så behagelig med asynkrone strømme, skal man bruge synkrone strømme så ofte som muligt, og kun asynkrone hvis det er nødvendigt.
Standardstrømme
Antag at du har to objekter, for eksempel en AudioProducer og en AudioConsumer. AudioProducer har en uddatastrøm og AudioConsumer har en inddatastrøm. Hver gang du vil forbinde dem, bruger du disse to strømme. Den første brug af defaulting er at lade dig oprette forbindelsen uden at angive portene i dette tilfælde.
Antag nu at de to objekter ovenfor kan håndtere stereo, og begge har en venstre
og højre
port. Du vil stadigvæk skulle kunne koble dem sammen lige så let som tidligere. Men hvordan kan forbindelsesystemet vide hvilken udgang som skal kobles til hvilken indgang? Det har ingen måde at koble strømmene rigtigt sammen. Defaulting bruges så til at angive flere strømme med en vis rækkefølge. På den måde, hvis du forbinder et objekt med to standard uddatastrømme til et andet med to standard inddatastrømme, behøver du ikke angive portene, og forbindelserne gøres rigtigt.
Dette er naturligvis ikke begrænset til stereo. Hvilket som helst antal strømme kan gøres standard hvis det behøves, og forbindelsesfunktionen kontrollerer at antallet af standarder for to objekter passer sammen (med de angivne retninger) hvis du ikke angiver portene som skal bruges.
Syntaksen er den følgende: I &IDL; kan du bruge nøgleordet default i strømdeklarationen, eller på en enkelt linje. For eksempel:
interface TwoToOneMixer {
default in audio stream input1, input2;
out audio stream output;
};
I dette eksempel kommer objektet til at forvente at dets to inddataporte skal forbindes som standard. Rækkefølgen er den som angives på linjen, så et objekt som dette:
interface DualNoiseGenerator {
out audio stream bzzt, couic;
default couic, bzzt;
};
laver automatisk en forbindelse fra couic
til input1
, og bzzt
til input2
Bemærk at eftersom der kun er én udgang for mikseren, kommer den til at være standard i dette tilfælde (se nedenfor). Syntaksen som bruges i støjgeneratoren er nyttig til for at angive en anden rækkefølge end i deklarationen, eller til kun at vælge nogle få porte som standard. Retningen på portene på denne linje slås op af &mcopidl;, så angiv dem ikke. Du kan til og med blande ind- og udporte på en sådan linje, kun rækkefølgen spiller en rolle.
Der er nogle regler som følges når arv bruges:
Hvis en standardliste angives i &IDL; så skal den bruges. En forælders port kan også indgå i listen, hvad enten de var standard forælderen eller ej.
Ellers arves forældrenes standarder. Rækkefølgen er forælder1 forvalg1, forælder1 forvalg2..., forælder2 forvalg1... Hvis der er en fælles forfader som bruger to forældregrene, laves en sammenfletning som ligner virtual public
ved standardens første plads i listen.
Hvis der stadigvæk ikke er nogen standard og en eneste strøm i en vis retning, så bruges den som standard for den retning.
Ændringsmeddelelser for attributter
Ændringsmeddelelser for attributter er en måde at vide når en attribut ændres. De kan i en vis udstrækning sammenlignes med et &Qt;- eller Gtk-signal eller slot. Hvis du for eksempel har et grafisk element, en skyder, som indstiller et tal mellem 0 og 100, har du oftest et objekt som gør noget med tallet (det kan for eksempel kontrollere lydstyrken på et lydsignal). Så vil du gerne at så snart skyderen flyttes skal objektet som indsteller lydstyrken underrettes. En forbindelse mellem en sender og modtagar.
&MCOP; håndterer dette ved at kunne give meddelelser når attributter ændres. Alt som deklareres som attribute
i &IDL; kan afgive sådanne ændringsmeddelelser, og skal gøre det, nårsomhelst de ændres. Alt som deklareres som attribute
kan også modtage sådanne ændringsmeddelelser. Så hvis du for eksempel har to &IDL;-grænseflader såsom disse her:
interface Slider {
attribute long min,max;
attribute long position;
};
interface VolumeControl : Arts::StereoEffect {
attribute long volume; // 0..100
};
kan du forbinde dem med ændringsmeddelelser. Det virker med det normale flydesystems forbindelsesoperation. I dette tilfælde, ser C++ koden som forbinder de to objekter sådan her ud
#include <connect.h>
using namespace Arts;
[...]
connect(slider,"position_changed",volumeControl,"volume");
Som du kan se, tilbyder hver egenskab to forskellige strømme, en for at sende ændringsmeddelelser, som hedder attributnavn_changed, og en til at modtage ændringsmeddelelser, som hedder attributnavn.
Det er vigtigt at vide at ændringsmeddelelser og asynkrone strømme passer sammen. De er også netværkstransparente. Så du kan forbinde en flyttelsesegenskabs ændringsmeddelelse for en grafisk komponent til en asynkron strøm for en syntesemodul som kører på en anden maskine. Dette betyder naturligvis også at ændringsmeddelelser ikke er synkrone, hvilket betyder at det kan tage tid inden de virkelig modtages efter at du har sendt dem.
Send ændringsmeddelelser
Når du implementerer objekter som har egenskaber, skal du sende ændringsmeddelelser så snart en egenskab ændres. Koden til at gøre dette ser sådan her ud:
void KPoti_impl::value(float newValue)
{
if(newValue != _value)
{
_value = newValue;
value_changed(newValue); // <- send ændringsmeddelelse
}
}
Det anbefales varmt at bruge kode som denne for alle objekter som du implementerer, så ændringsmeddelelser kan bruges af andre. Du bør dog undgå at sende meddelelser for ofte, så hvis du laver signalbehandling er det formodentlig bedst at holde styr på hvornår du sendte din seneste meddelelse, så du ikke sender en for hver sampling.
Anvendelser af ændringsmeddelelser
Det vil være særligt nyttigt at bruge ændringsmeddelelser sammen med målere (objekter som for eksempel visualiserer lyddata), grafiske grænseflader, kontrolelementer og monitorer. Kode som bruger dette findes i kdelibs/arts/tests, og i den eksperimentelle artsgui-implementation, som du finder i kdemultimedia/arts/gui.
Filen .mcoprc
Filen .mcoprc (i hver brugers hjemmemappe) kan bruges til at indstille &MCOP; på nogle måder. For øjeblikket er følgende muligt:
GlobalComm
Navnet på en grænseflade som skal bruges til global kommunikation. Global kommunikation bruges til at finde andre objekter og hente den hemmelige cookie. Alle &MCOP; klienter/servere som skal kunne kommunikere med hinanden skal have et GlobalComm-objekt for at kunne dele information. For øjeblikket er de mulige værdier Arts::TmpGlobalComm
for at kommunikere via mappen /tmp/mcop-brugernavn (som kun virker på den lokale maskine) og Arts::X11GlobalComm
for at kommunikere via rootvinduesegenskaberne på X11-serveren.
TraderPath
Angiver hvor handlerinformation skal findes. Du kan angive mere end en mappe her, og adskille dem med kommategn.
ExtensionPath
Angiver fra hvilke mapper udvidelser (i form af delte biblioteker) indlæses. Flere værdier kan adskilles med kommategn.
Et eksempel som bruger alt det ovenstående er:
# $HOME/.mcoprc file
GlobalComm=Arts::X11GlobalComm
# hvis du er udvikler kan det være bekvemt at tilføje et mappe i din
# hjemmemappe til TraderPath/ExtensionPath søgestierne for at kunne tilføje
# til komponenter uden at installere dem
TraderPath="/opt/kde2/lib/mcop","/home/joe/mcopdevel/mcop"
ExtensionPath="/opt/kde2/lib","/home/joe/mcopdevel/lib"
&MCOP; for CORBA-brugere
Hvis du har brugt CORBA tidligere, vil du kunne mærke at &MCOP; er meget lig. I virkeligheden så brugte &arts; CORBA inden version 0.4.
Den grundlæggende idé med CORBA er den samme: man implementerer objekter (komponenter). Ved at bruge funktionerne i &MCOP; er objekter ikke kun tilgængelige som normale klasser fra samme proces (via standard C++ teknikker), men de er også transparent tilgængelige for en fjernserver. For at dette skal virke, er det første du skal gøre at specificere grænsefladen for dine objekter i en &IDL;-fil, præcis som for CORBA-&IDL;. Der er kun et fåtal af forskelle.
CORBA-funktioner som mangles i &MCOP;
I &MCOP; er der ingen in
og out
parametre for metodekald. Parametre er altid indgående, og returværdien er altid udgående, hvilket betyder at grænsefladen:
// CORBA idl
interface Account {
void deposit( in long amount );
void withdraw( in long amount );
long balance();
};
skrives som
// MCOP idl
interface Account {
void deposit( long amount );
void withdraw( long amount );
long balance();
};
i &MCOP;.
Der er ingen støtte for undtagelser. &MCOP; har ikke undtagelser, den bruger noget andet til fejlhåndtering.
Der er ingen union-typer og ingen typedefinitioner. Jeg ved ikke om det er en virkelig svaghed, noget man desperat behøver for at overleve.
Der er ingen understøttelse for at sende grænseflader eller objektreferencer
CORBA-funktioner som er anderledes i &MCOP;
Du deklarerer sekvenser som sequencetyp
i &MCOP;. Der er intet behov for en typedefinition. For eksempel, i stedet for:
// CORBA idl
struct Line {
long x1,y1,x2,y2;
};
typedef sequence<Line> LineSeq;
interface Plotter {
void draw(in LineSeq lines);
};
ville du skrive
// MCOP idl
struct Line {
long x1,y1,x2,y2;
};
interface Plotter {
void draw(sequence<Line> lines);
};
&MCOP;-funktioner som ikke findes i CORBA
Du kan deklarere strømme, som senere behandles af &arts;' skelet. Strømme deklareres på en måde som ligner egenskaber. For eksempel:
// MCOP idl
interface Synth_ADD : SynthModule {
in audio stream signal1,signal2;
out audio stream outvalue;
};
Dette betyder at dit objekt vil acceptere to indkommende synkrone lydstrømme som kaldes signal1 og signal2. Synkron betyder at de er strømme som leverer x samplinger pr sekund (eller anden tid), så skemalæggeren altid garanterer at du får en balanceret mængde inddata (f.eks. 200 samplinger af signal1 er der og 200 samplinger af signal2 er der). Du garanterer at hvis dit objekt kaldes med disse 200 samplinger af signal1 + signal2, så kan det producere præcis 200 samplinger uddata.
&MCOP;-bindingen til C++ sproget
Dette adskiller sig fra CORBA i hovedsagen hvad angår:
Strenge bruger C++ STL-klassen string. Når de opbevares i sekvenser, opbevares de enkelt
, hvilket betyder at de anses for at være en primitiv type. Derfor behøver de at blive kopieret.
long er enkle long (forventes at være 32 bit).
Sekvenser bruger C++ STL-klassen vector.
Strukturer afledes alle fra &MCOP; klassen Type, og genereres af &MCOP; &IDL;-oversætteren. Når de opbevares i sekvenser, opbevares de ikke enkelt
, men som pegere, eftersom der ellers ville opstå for meget kopiering.
Implementering af &MCOP;-objekter
Efter at have sendt dem gennem &IDL;-oversætteren, skal du aflede fra klassen _skel. Antag for eksempel at du har defineret grænsefladen sådan her:
// MCOP idl: hello.idl
interface Hello {
void hello(string s);
string concat(string s1, string s2);
long sum2(long a, long b);
};
Du sender det gennem &IDL;-oversætteren ved at kalde mcopidl hello.idl, som derefter laver hello.cc og hello.h. For at implementere dette, behøver du en C++ klasse som arver skelettet:
// C++ deklarationsfil - indsæt hello.h et sted
class Hello_impl : virtual public Hello_skel {
public:
void hello(const string& s);
string concat(const string& s1, const string& s2);
long sum2(long a, long b);
};
Til sidst skal du implementere metoderne som almindelig C++.
// C++ implementeringsfil
// som du ser sendes strenge som konstante strengreferencer
void Hello_impl::hello(const string& s)
{
printf("Hello '%s'!\n",s.c_str());
}
// når de er en returværdi sendes de som "normale" strenge
string Hello_impl::concat(const string& s1, const string& s2)
{
return s1+s2;
}
long Hello_impl::sum2(long a, long b)
{
return a+b;
}
Når du har gjort dette, har du et objekt som kan kommunikere med &MCOP;. Opret kun et (med de normale C++ faciliteter til at oprette et objekt):
Hello_impl server;
Og så snart du giver nogen referencen
string reference = server._toString();
printf("%s\n",reference.c_str());
og gå til &MCOP;:s venteløkke
Dispatcher::the()->run();
har alle adgang til objektet med
// denne kode kan køre hvorsomhelst - ikke nødvendigtvis i samme proces
// (den kan også køre på en anden maskine/arkitektur)
Hello *h = Hello::_fromString([objektreferencen som blev udskrevet ovenifor]);
og kalde-metoder:
if(h)
h->hello("test");
else
printf("Adgang mislykkedes?\n");
Sikkerhedshensyn for &MCOP;
Eftersom en &MCOP;-server lytter på en TCP-port, kan potentielt set alle (hvis du er forbundet til internettet) forsøge at forbinde til en &MCOP;-tjeneste. Derfor er det vigtigt at identificere klienter. &MCOP; bruger md5-auth protokollen.
Protokollen md5-auth gør følgende for at sikre at kun udvalgte (pålidelige) klienter kan forbinde til en server:
Den antager at du kan give hver klient en hemmelig cookie.
Hver gang en klient forbindes, verificerer den at denne klient kender til den hemmelige cookie, uden virkelig at sende den (ikke engang på en form som nogen som lytter på netværkstrafik kunne finde ud af).
For at give hver klient den hemmelige cookie, putter &MCOP; den (normalt) i mcop mappen (i /tmp/mcop-USER/secret-cookie). Du kan naturligvis kopiere den til andre maskiner. Men hvis du gør det, så brug en sikker overførselsmekanisme, såsom scp (fra ssh).
Godkendelsen af klienter anvender følgende skridt:
[SERVER] opret en ny (tilfældig) cookie R
[SERVER] send den til klienten
[KLIENT] læs den "hemmelige cookie" S fra en fil
[KLIENT] bland cookierne R og S for at oprette en blandet cookie M med MD5-algoritmen
[KLIENT] send M til serveren
[SERVER] verificerer at blanding af R og S giver præcis samme cookie som cookien M som blev modtaget fra klienten. Hvis dette stemmer er godkendelsen lykkedes.
Denne algoritme skulle være sikker, under forudsætning af at
De hemmelige og tilfældige cookier er tilfældige nok
og
MD5-algoritmen ikke tillader at originalteksten
kan afgøres, det vil sige den hemmelige cookie S og den tilfældige cookie R (som er kendt alligevel), fra den blandede cookie M.
&MCOP;-protokollen starter hver ny forbindelse med en godkendelsesprocess. Basalt ser den sådan her ud:
Serveren sender meddelelsen ServerHello, som beskriver de kendte godkendelsesprotokoller.
Klienten sender meddelelsen ClientHello, som indeholder godkendelsesinformation.
Serveren sender meddelelsen AuthAccept.
For at se at sikkerheden virkelig virker, bør vi kigge på hvordan meddelelser behandles for ikke godkendte forbindelser:
Inden godkendelsen er lykkedes, tager serveren ikke imod andre meddelelser fra forbindelsen. I stedet, hvis serveren for eksempel forventer sig meddelelsen ClientHello
, og får meddelelsen mcopInvocation, så lukker den ned for forbindelsen.
Hvis klienten ikke sender en gyldig &MCOP;-meddelelse overhovedet (ingen magisk værdi &MCOP; i meddelelseshovedet) i godkendelsesfasen, uden noget andet, så lukkes der for forbindelsen.
Hvis klienten forsøger at sende en meget stor meddelelse (> 4096 byte) under godkendelsesfasen, kappes meddelelsesstørrelsen ned til 0 byte, hvilket gør at den ikke accepteres til godkendelse. Dette er der for at forhindre at ikke godkendte klienter sender f.eks. en 100 Mbyte meddelelse, som ville blive modtaget og kunne forårsage at serveren løber tør for hukommelse.
Hvis klienten sender en fejlagtig ClientHello meddelelse (en hvor afkodningen mislykkes), så lukkes der for forbindelsen.
Hvis klienten ikke sender noget i det hele taget, skal en tidsgrænse overskrides (endnu ikke implementeret).
&MCOP; protokolspecifikation
Indledning
Den har begrebsmæssige ligheder med CORBA, men er beregnet til at kunne udvides på alle måder som kræves for multimediaoperationer i realtid.
Den sørger for en multimediaobjektmodel, som både kan bruges til kommunikation mellem komponenter i et adresserum (en proces), og mellem komponenter som findes i forskellige tråde, processer eller på forskellige værtsmaskiner.
Totalt set, vil den blive konstrueret til ekstremt høj ydelse (så alt skal optimeres for at være voldsomt hurtigt), passende for meget kommunikationsintensive multimedieprogrammer. At for eksempel sende video rundt er en af tilpasningerne for &MCOP;, hvor de fleste CORBA-implementationer ville gå i knæ.
Grænsefladedefinitionerne kan håndtere følgende selv:
Kontinuerlige datastrømme (såsom lyddata).
Begivenhedsstrømme af data (såsom &MIDI;-begivenheder).
Rigtig referenceregning.
og de vigtigste CORBA-kneb, såsom
Synkrone metodekald.
Asynkrone metodekald.
Konstruere brugerdefinerede datatyper.
Multipel arv.
Sende objektreferencer.
&MCOP;'s meddelelseskodning
Konstruktionsmål/idéer:
Kodning skal være enkelt at implementere.
Afkodning kræver at modtageren véd hvilken type som skal afkodes.
Modtageren forventes at bruge al information, så mulighed for at hoppe over data findes kun i protokollen i det omfang at:
Hvis man ved at en blok af data bliver modtaget, behøver man ikke kigge på hver del efter en slutmarkør.
Hvis man ved at en streng vil blive modtaget, behøver man ikke læse til en null-byte for at finde ud af dens længde ved afkodning, men,
Hvis man véd at en sekvens af strenge bliver modtaget skal man kigge på længden for hver af dem for at finde ud af slutningen af sekvensen, eftersom strenge har variabel længde. Men hvis strengene bruges til noget nyttigt, skal det gøres i alle tilfælde, så dette er ikke noget tab.
Så lidt ekstra omkostning som muligt.
Kodningen af de forskellige typer vises i tabellen nedenfor:
Type
Kodningsproces
Resultat
void
typen void kodes ved at udelade den, så ingenting skrives til strømmen for den.
long
kodes som fire byte, med den mest signifikante først, så tallet 10001025 (som er 0x989a81) vil blive kodet som:
0x00 0x98 0x9a 0x81
nummereringstyper
kodes som long
byte
kodes som en enkelt byte, så 0x42 vil blive kodet som:
0x42
streng
kodes som en long, som indeholder længden på den efterfølgende streng, og derefter sekvensen af tegn. Strenge skal slutte med en null-byte (som indgår i længdeberegningen).
inklusive den sidste 0 byte i længderegningen!
hello
ville blive kodet som:
0x00 0x00 0x00 0x06 0x68 0x65 0x6c 0x6c 0x6f 0x00
boolean
kodes som en byte, som indeholder 0 hvis false eller 1 hvis true, så at den booleske værdi true kodes som:
0x01
float
kodes med fire-byte IEEE754 repræsentationen, detaljeret dokumentation om hvordan IEEE fungerer findes her: http://twister.ou.edu/workshop.docs/ common-tools/ numerical_comp_guide/ ncg_math.doc.html og her: http://java.sun.com/docs/books/ vmspec/ 2nd-edition/ html/ Overview.doc.html. Så værdien 2,15 ville blive kodet som:
0x9a 0x99 0x09 0x40
struct
En struktur kodes ved at kode dens indhold. Der kræves ingen yderligere præfiks eller suffiks, så strukturen
struct test {
string name; // som er "hello"
long value; // som er 10001025 (0x989a81)
};
ville blive kodet som:
0x00 0x00 0x00 0x06 0x68 0x65 0x6c 0x6c
0x6f 0x00 0x00 0x98 0x9a 0x81
sekvens
En sekvens kodes ved at lave en liste over antallet af elementer som følger, og derefter kode elementerne en efter en.
Så en sekvens med tre "long a", med a[0] = 0x12345678, a[1] = 0x01 og a[2] = 0x42 ville blive kodet som
0x00 0x00 0x00 0x03 0x12 0x34 0x56 0x78
0x00 0x00 0x00 0x01 0x00 0x00 0x00 0x42
Hvis du har brug for at henvise til en type, angives alle primitive typer med navnene som findes ovenfor. Strukturer og nummereringstyper får deres egne navne (som Header). Sekvenser benævnes som *normal type, så en sekvens af long er *long
og en sekvens af Header struct'er er *Header
.
Meddelelser
Formatet på &MCOP;'s meddelelseshovede defineres af denne struktur:
struct Header {
long magic; // værdien 0x4d434f50, som kodes som MCOP
long messageLength;
long messageType;
};
De mulige meddelelsetyper er for øjeblikket
mcopServerHello = 1
mcopClientHello = 2
mcopAuthAccept = 3
mcopInvocation = 4
mcopReturn = 5
mcopOnewayInvocation = 6
Lidt information om &MCOP;'s meddelelseshåndtering:
Hver meddelelse begynder med et hoved.
Visse meddelelsestyper skal ignoreres af serveren, indtil godkendelsen er færdig.
Efter at hovedet er modtaget, kan protokolhåndteringen (forbindelsen) tage imod meddelelsen i sin helhed, uden at kigge på indholdet.
Meddelelseslængden i hovedet er naturligvis sommetider redundant, hvilket gør at metoden ikke altid er minimal med hensyn til antal byte.
Dette giver dog en enkel (og hurtig) implementation for behandling af meddelelser som ikke blokerer. Ved hjælp af hovedet kan meddelelser modtages af protokolhåndteringsklasser i baggrunden (uden blokering), hvis der er mange forbindelser til serveren kan alle behandles parallelt. Man behøver ikke kigge på meddelelsens indhold for at tage imod en meddelelse (og afgøre når man er klar), kun på hovedet, så koden for dette er ganske enkel.
Når en meddelelse er på plads, kan den afkodes og behandles i et enkelt skridt, uden at bryde sig om tilfælde hvor al data måske ikke er modtaget (eftersom meddelelseslængden garanterer at alt er på plads).
Kald
For at kalde en fjernmetode, skal man sende følgende struktur i en &MCOP;-meddelelse med messageType = 1 (mcopInvocation):
struct Invocation {
long objectID;
long methodID;
long requestID;
};
derefter sendes parametrene som en struktur, f.eks. hvis man kalder metoden "string concat(string s1, string s2)", sendes strukturen
struct InvocationBody {
string s1;
string s2;
};
hvis metoden deklareredes som envejs, hvilket betyder asynkront uden returværdi, er det alt. Ellers får man en meddelelse som svar med messageType = 2 (mcopReturn).
struct ReturnCode {
long requestID;
<resulttype> result;
};
hvor <resulttype> er typen for resultatet. Eftersom void-typer udelades ved kodning, kan man også kun angive requestID hvis man returnerer fra en void-metode.
Så vor "string concat(string s1, string s2)" ville give en returkode som
struct ReturnCode {
long requestID;
string result;
};
Inspektér grænseflader
For at lave kald, skal man kende til metoderne som et objekt understøtter. For at gøre dette, er methodID 0, 1, 2 og 3 hårdkodede for visse funktioner. Det vil sige
long _lookupMethod(MethodDef methodDef); // metode-id altid 0
string _interfaceName(); // metod-id altid 1
InterfaceDef _queryInterface(string name); // metodie-id altid 2
TypeDef _queryType(string name); // metodie-id altid 3
for at læse dette, behøver du naturligvis også
struct MethodDef {
string methodName;
string type;
long flags; // nu sat til 0 (kræves for strømme)
sequence<ParamDef> signature;
};
struct ParamDef {
string name;
long typeCode;
};
parameterfeltet indeholder typekomponenter som angiver typerne for parametrene. Typen for returkoden angives i typefeltet for MethodDef.
Hvis man skal være streng, er det kun metoderne _lookupMethod() og _interfaceName() som varierer fra objekt til objekt, mens _queryInterface() og _queryType() altid er ens.
Hvad er en sådan her methodID? Hvis man laver et &MCOP;-kald, forventes man at sende nummeret for metoden som kaldes. Årsagen til dette er at numre kan behandles meget hurtigere end strenge når en &MCOP;-forespørgsel køres.
Så hvordan skaffer man sig et sådan nummer? Hvis man kender til signaturen for metoden, dvs. en MethodDef som beskriver den (som indeholder navn, type, parameternavn, parametertyper og lignende), så kan man sende den til _lookupMethod for objektet hvor man vil kalde en metode. Eftersom _lookupMethod er hårdkodet til methodID 0, skulle det ikke være nogen problem at gøre dette.
Hvis man på den anden side ikke kender til metodens signatur, kan man finde hvilke metoder der understøttes ved at bruge _interfaceName, _queryInterface og _queryType.
Typedefinitioner
Brugerdefinerede datatyper beskrives med strukturen TypeDef:
struct TypeComponent {
string type;
string name;
};
struct TypeDef {
string name;
sequence<TypeComponent> contents;
};
Hvorfor &arts; ikke bruger &DCOP;
Eftersom &kde; droppede CORBA fuldstændigt, og i stedet bruger &DCOP; overalt, opstår naturligvis spørgsmålet hvorfor ikke &arts; også gør det. Trods alt findes &DCOP;-understøttelse i KApplication, er godt vedligeholdt, forventes at integreres udmærket med libICE, og alt muligt andet.
Eftersom der (muligvis) vil være mange som spørger om det virkelig er nødvendigt at have &MCOP; foruden &DCOP;, så er svaret her. Misforstå mig ikke, jeg forsøger ikke at sige at &DCOP; er dårlig
. Jeg forsøger kun at sige at &DCOP; ikke er den rette løsning for &arts;
(mens det er en god løsning for andre ting).
Først skal man forstå nøjagtigt hvad &DCOP; blev skrevet for. Oprettet på to dage under mødet &kde;-TWO, var det hensigten at være så enkel som muligt, en virkelig letvægts
kommunikationsprotokol. I særdeleshed udelod implementationen alt som kunne indebære kompleksitet, for eksempel et fuldstændigt begreb om hvordan datatyper skal kodes.
Selvom &DCOP; ikke bryder sig om visse ting (som hvordan man sender en streng på en netværkstransparent måde), skal dette gøres. Så alt som &DCOP; ikke gør overlades til &Qt; i &kde;-programmerne som bruger &DCOP; i dag. Dette er i hovedsagen typehåndtering (som bruger &Qt;'s serialiseringsoperator).
Så &DCOP; er en minimal protokol som gør det helt muligt for &kde;-programmer at sende enkle meddelelser såsom åbn et vindue som peger på http://www.kde.org
eller dine indstillinger er ændrede
. Inde i &arts; fokuseres imidlertid på andre ting.
Idéen er at små plugin i &arts; skal kommunikere med sådanne datastrukturer som midi-begivenheder
og sangpositionspegere
og flydegrafer
.
Dette er komplekse datatyper, som skal sendes mellem forskellige objekter, og håndteres som strømme, eller parametre. &MCOP; sørger for et typebegreb til at definere komplekse datatyper ud fra enklere (ligesom struct'er og felter i C++). &DCOP; bryder sig ikke om typer i det hele taget, så dette problem skulle overlades til programmøren, såsom at skrive C++ klasser for typerne, og sikre sig at de kan serialisere på en rigtig måde (for eksempel understøttelse for &Qt;'s serialiseringsoperator).
Men på den måde ville de ikke være tilgængelige for noget andet end direkte kodning i C++. I særdeleshed ville man ikke kunne oprette et scriptsprog som ville kunne kende til alle typer som et plugin kan gøre tilgængelige, eftersom de ikke ville være selvbeskrivende.
Samme argument gælder også grænseflader i stor udstrækning. &DCOP;-objekter gør ikke deres forhold, arvhierarkier, osv. tilgængelige. Hvis man ville skrive en objektbladrer som ville vise hvilke egenskaber har dette objekt
, ville det mislykkes.
Selvom Matthias fortalte mig at man har en speciel funktion functions
for hvert objekt som informerer om hvilke metoder som objektet understøtter, udelader dette ting såsom egenskaber, strømme og arvrelationer.
Dette gør at programmer som &arts-builder; ikke ville fungere overhovedet. Men husk, det var ikke meningen at &DCOP; skulle være en objektmodel (eftersom &Qt; allerede har en med moc og lignende), heller ikke være noget som CORBA, men sørge for kommunikation mellem programmer.
Årsagen til at &MCOP; overhovedet findes er at den skal virke godt med strømme mellem objekter. &arts; bruger mange små plugin, som forbindes med strømme. CORBA-versionen af &arts; var tvunget til at introducere en besværlig opdeling mellem SynthModule-objekt
, som var de interne arbejdsmoduler som oprettede strømme, og CORBA-grænseflade
, som var noget eksternt.
Meget kode bekymrede sig om at opnå at vekselvirkningen mellem SynthModule-objekt
og CORBA-grænsefladen
så naturlig ud, men den gjorde det aldrig, eftersom CORBA ikke kendte til noget om strømme overhovedet. &MCOP; gør det. Kig på koden (noget i stil med simplesoundserver_impl.cc). Adskilligt bedre! Strømme kan deklareres i modulernes grænseflade, og implementeres på en måde som ser naturlig ud.
Man kan ikke benægte det. En af grunderne til at jeg skrev &MCOP; var hurtighed. Her er et argument for at &MCOP; definitivt vil være hurtigere end &DCOP; (selv uden at angive tal).
Et kald i &MCOP; vil have et hoved med seks long
. Det vil sige:
magisk værdi MCOP
meddelelsetype (kald)
størrelse på forespørgsler i byte
ID for forespørgsler
ID for målobjektet
ID for målmetoden
Efter dette følger parametrene. Bemærk at afkode dette går ekstremt hurtigt. Man kan bruge tabelopslag for at finde afkodningsfunktionen for objektet og metoden, hvilket betyder at kompleksiteten er O(1) [det tager lige lang tid uafhængig af hvor mange objekter som findes, og hvor mange funktioner som findes].
Hvis dette sammenlignes med &DCOP;, ser du at der er i det mindste
en streng for målobjektet - noget i stil med myCalculator
en streng som ligner addNumber(int,int)
for at angive metoden
yderligere protokolinformation tilføjet af libICE, og andre DCOP-specifikke ting som jeg ikke kender til
Disse er meget sværere at afkode, eftersom man skal tolke strengen, lede efter funktionen, osv.
Med &DCOP; sendes alle kald gennem en server (DCOPServer). Det betyder at håndteringen af et synkront kald ser sådan her ud:
Klientprocessen sender kald.
DCOPserver (manden i midten) tager imod kaldet og ser efter hvor det skal hen, og sender det til den rigtige
server.
Serverprocessen tager imod kaldet, udfører forespørgsler og sender resultatet.
DCOPserver (manden i midten) tager imod resultatet og ... sender det til klienten.
Klienten afkoder svaret.
I &MCOP; ser samme kald ud sådan her ud:
Klientprocessen sender kald.
Serverprocessen tager imod kaldet, udfører forespørgsler og sender resultatet.
Klienten afkoder svaret.
Antag at begge er rigtigt implementerede. &MCOP;'s ikke-hierarkiske strategi bør være hurtigere med en faktor to, end &DCOP;'s mand i midten-strategi. Bemærk dog at der naturligvis var grunde til at vælge &DCOP;-strategien, som er at hvis du har 20 programmer som kører, og hvert program taler med hvert andet program, så behøver man 20 forbindelser med &DCOP;, og 200 med &MCOP;. I tilfældet med multimedie er det dog ikke meningen at dette skal være et almindeligt scenario.
Jeg forsøgte at sammenligne &MCOP; og &DCOP;, med at gøre et kald som lægger to tal sammen. Jeg ændrede testdcop for at opnå dette. Testen var dog måske ikke præcis på &DCOP;-siden. Jeg kaldte metoden i samme proces som gjorde kaldet til &DCOP;, og jeg vidste ikke hvordan man blev af med en fejlsøgningsmeddelelse, så jeg brugte omdirigering af udskriften.
Testen brugte kun et objekt og en funktion, så resultaterne for &DCOP; forventes at blive mindre med flere objekt og funktioner, mens resultaterne for &MCOP; bør forblive de samme. Desuden var dcopserver-processen ikke forbundet til andre programmer, og det er måske sådan at hvis mange programmer er forbundne så mindskes overføringsydelsen.
Resultatet jeg fik var at mens &DCOP; fik lidt mere end 2000 kald pr sekund, fik &MCOP; noget mere end 8000 kald pr sekund. Det betyder en faktor 4. Jeg véd at &MCOP; ikke er afstemt for den maksimalt mulige hastighed endnu. (Som sammenligning: CORBA, med mico-implementationen, klarer noget mellem 1000 og 1500 kald pr sekund).
Hvis du vil have rigtigere
data, så overvej at skrive et lille måleprogram for &DCOP; og send det til mig.
CORBA havde den behagelige funktion at man kunne bruge objekter som man havde implementeret, som separat serverproces
, eller som bibliotek
. Man kunne bruge samme kode for at gøre det, og CORBA bestemte transparent hvad der skulle gøres. Med &DCOP;, er det ikke rigtigt meningen, og så vidt jeg ved ikke egentlig muligt.
&MCOP; på den anden siden skulle understøtte dette fra begyndelsen. Så man kan køre en effekt inde i &artsd;. Men for en bølgeformseditor kan man også vælge at køre samme effekt inde i processen.
Mens &DCOP; i hovedsagen er en måde at kommunikere mellem programmer, er &MCOP; også en måde at kommunikere inde i programmerne. Især for multimediestrømme er dette vigtigt (eftersom man kan køre flere &MCOP;-objekter parallelt, for at løse en multimediaopgave i et program).
Selvom &MCOP; ikke gør det for øjeblikket, er mulighederne åbne for at implementere servicekvalitetsfunktioner. Noget i stil med at den &MIDI;-begivenhed er virkelig rigtigt vigtig, sammenlignet med dette kald
. Eller noget som skal være der til tiden
.
På den anden siden kan strømoverførsler integreres i &MCOP;-protokollen på en behagelig måde, og kombineres med QoS-ting. Under forudsætning af at protokollen kan ændres, bør &MCOP; strømoverførsler ikke blive virkelig langsommere end en konventionel TCP-strøm, men de vil være enklere og mere konsekvente at bruge.
Der er ingen grund til at basere mellemprogrammer for multimedie på &Qt;. Ved at bestemme sig for det, og bruge alle de behagelige &Qt;-strømme og andre ting, kan det let føre til at mellemprogrammer kun bliver en sag for &Qt;-(eller i virkeligheden kun &kde;). Jeg mener at hvis jeg nogensinde ser at GNOME også bruger &DCOP;, eller noget lignende, er det naturligvis beviset for at jeg har taget fejl.
Selvom jeg ved at &DCOP; i grunden ikke kender til de datatyper som den sender, så man ville kunne bruge &DCOP; uden &Qt;, se hvordan den bruges i daglig &kde;-brug: man sender typer rundt såsom QString, QRect, QPixmap, QCString, .... Disse bruger &Qt;'s-serialisering. Så hvis nogen vælger at understøtte &DCOP; i et GNOME-program, skal han enten angive at han bruger QString,... typer (selvom han ikke gør det), og emulere måden som &Qt; bruger til strømme, eller også skulle han sende andre streng-, pixmap- og rect-typer rundt, og på den måde alligevel ikke kunne virke sammen med &kde;-programmer.
Nå, under alle omstændigheder var det altid meningen at &arts; var beregnet til at virke med eller uden &kde;, med eller uden &Qt;, med eller uden X11, og måske til og med med eller uden &Linux; (og jeg har ikke engang indvendinger mod personer som tilretter den til operativsystemer som ikke er frie).
Min indstilling er at komponenter som ikke indgår i en grafisk grænseflade skal skrives uafhængig af denne, for at muliggøre at de deles mellem et større antal udviklere (og brugere).
Jeg indser at brug af to IPC-protokoller kan være ubekvemt. Desuden er begge to ikke standardiserede. Af de grunde som blev angivet ovenfor er det ikke muligt at skifte til &DCOP;. Hvis der er betydeligt interesse i at finde en måde at forene de to, så kan vi forsøge. Vi ville til og med kunne forsøge at få &MCOP; til at tale IIOP, når skulle vi have en CORBA ORB ;).
Jeg talte en del med Matthias Ettrich om fremtiden med de to protokoller, og vi fandt mange måde som tingene kunne gå videre. &MCOP; ville for eksempel kunne håndtere meddelelsekommunikationen i &DCOP;, og på denne måde få protokollerne nærmere til hinanden
Nogle mulige løsninger ville være:
Skriv en portal mellem &MCOP; og &DCOP; (hvilket bør være muligt, og ville muliggøre samkørsel). Bemærk at der findes en eksperimentel prototype, hvis du skulle have lyst til at arbejde med det.
Integrér alt det &DCOP;-brugere forventer sig i &MCOP;, og forsøg kun at bruge &MCOP; - man skulle også kunne tilføje en mand i midten
mulighed i &MCOP;)
Basér &DCOP; på &MCOP; i stedet for libICE, og begynd langsomt at integrere tingene tættere sammen.
Den værste mulighed er måske ikke at bruge hver protokol til alt det som den var beregnet til (der er nogle store forskelle i målene med deres konstruktion), og ikke forsøge slå dem sammen til et.