gmane.comp.mobile.synthesis

Re: libsynthesis and SonyEricsson Xperia S ownSyncML client

Lukas Zeller — 2012-05-24T12:53:12


:-)


This is a SyncML TK error code and means "Document does not conform to SyncML DTD". If you have console output for the library, you'll see the decoding messages there, along with some context where it happens. That would be useful.

By default, libsynthesis does not output console messages, but you can set the config variable "conferrpath" to "console" to have it on stdout or specify a file path for storing the console messages.


Apparently, the xperia has a number of small WBXML issues, so the most interesting part of the logs at this time would be the console messages with the SyncML TK output. Of course, the .html log might also give some more context.


Makes sense. Quoting only the essential lines here is probably most helpful for the list audience.

Best Regards,

Lukas

Re: libsynthesis and SonyEricsson Xperia S own SyncML client

Andris Pavenis — 2012-05-24T10:59:33

That was due to one line bug in my HTTP server implementation. 
Authentication works OK after I fixed it. I'm getting however:

2012-05-24 13:19:11.528] Calling smlProcessData(NEXT_COMMAND)
[2012-05-24 13:19:11.528] ===> smlProcessData failed, returned 0x200B
–
[2012-05-24 13:19:11.528] 'SessionAbort' - Aborting Session, 
Status=20007, ProblemSource=LOCAL [--][++] [->end] [->enclosing]
[2012-05-24 13:19:11.528] WARNING: Aborting Session with Reason Status 
20007 (LOCAL problem) ***
[2012-05-24 13:19:11.528] --------------- Ignoring all commands in this 
message (after 0 sec. request processing, 0 sec. total) with Status 514 
(0=none) from here on
–
[2012-05-24 13:19:11.528] 'DSAbort' - Aborting datastore sync, 
abortStatusCode=20007, localProblem=yes, resumable=yes [--][++] [->end] 
[->enclosing]
[2012-05-24 13:19:11.528] events: testState=FALSE - expected 
state>='sync_set_ready', found state=='server_answered_alert'
–
[2012-05-24 13:19:11.528] 'SaveSuspendState' - Saving state for 
suspend/resume, datastore=events [--][++] [->end] [->enclosing]

I'll collect required data (logs, messages) and send them separately 
(perhaps no need to send them to the list).

Andris

Re: libsynthesis and SonyEricsson Xperia S ownSyncML client

Lukas Zeller — 2012-05-24T08:08:36

Hi Andris,

On 24.05.2012, at 08:33, Andris Pavenis wrote:


Yes, I see that, but I can't find the matching wbxml incoming message dump in the *.wbxml you sent. All those 4 don't have the Cred element, IMHO.


That's wrong on SE's part, and is certainly the reason why Wireshark does not recognize it as SyncML, but apparently is not be a problem for the SyncML TK decoder. If it was a problem, it would not decode anything in that message.

Best Regards,

Lukas

Re: libsynthesis and SonyEricsson Xperia S own SyncML client

Andris Pavenis — 2012-05-24T06:33:07

It responds according with authentication to WireShark. Try using 
WireShark on capture file and decode port 9321 as HTTP.
wbxml2xml also fails to extract authentication information.

It seems however that public ID "//SYNCML//DTD SyncML 1.2//ENmlq\0031.2" 
instead of "//SYNCML//DTD SyncML 1.2//EN" also causes some problems. For 
example WireShark shows WBXML tag numbers instead of interpretting them 
as SyncML WBXML tags.

Forcing use of SyncML 1.2 for wbxml2xml does not help (wbxml2xml -l 
SYNCML12 ...)

Thanks.

Andris

Re: libsynthesis and SonyEricsson Xperia S ownSyncML client

Lukas Zeller — 2012-05-23T14:05:55

Hi Andris,

On 21.05.2012, at 15:43, Andris Pavenis wrote:

I found a bug which was causing this, and commited a fix in the luz branch (see https://gitorious.org/libsynthesis). The problem was that the XML encoder in the SyncML toolkit could not handle empty tags, but the SonyEricsson devInf contains a <OEM></OEM> empty tag.

So now the XML conversion of the messages you captured from the Xperia-S (aka LT26i) now work ok.

However, this does not explain the auth problems.

I don't see any authentication in the incoming messages, not in the XML translation and also not when looking at hexdumps of the WBXML. The only thing I see is the <LocName> test, but that's not enough for an auth attempt, there must be some credentials.

It is valid (or even recommended) for a device to try first without any credentials to see what auth method the server requests.

So the first of these attempts is perfectly ok, and the server responds with an authentication challenge for MD5 auth, which is the secure method which does not require user/pw to be transmitted over the line, but only a hash.

However, for some reason the LT26i does not respond to that challenge, but retries the "probe" again.

One reason for this could be that the device does not actually get the response, but just some transport level error, and thus just resends it's first message serveral times.
You said that there was some problem with chunked transport encoding - maybe there's a similar problem in the other direction such that the server result arrives garbled at the phone's end?

I recommend using the luz branch for testing - as it is always ahead of master and contains the latest patches before they are in master.

Best Regards,

Lukas

libsynthesis and SonyEricsson Xperia S own SyncMLclient

Andris Pavenis — 2012-05-21T13:43:18

Tried to test whether synchronization works with Xperia-S own SyncML 
client (comes with Android 2.3.7 installed on phone, software version 
6.0.A.3.73) using custom libsynthesis based SyncML server.

- the first problem was chunked transport encoding use by phone software 
initially not supported by mentioned above server software. It was 
however easy enough to fix.
- the next problem is failure of libsynthesis to get authentication 
information sent by phone extracted from messages. Also decoded incoming 
WBXML messages saved into XML format are corrupt. For unknown reason the 
client tries to synchronize at first without authentication even when 
both user name and password are specified in its configuration. 
Authentication is first provided in second attempt of 4 totally. 3 of 4 
incoming WBXML format packets seems to contain authentication 
information but also wbxml2xml does not show it

I'm including:
- wireshark capture of communications between client and server (local 
WLAN used)
- HTML format logs of all 4 attempts
- WBXML messages and decoded (at least tried) XML messages
- server output which allows to identify the order of SyncML sessions

as attached xz packed tar archive

Last tests was done with current GIT version of libsynthesis from master 
branch.

Andris

PS. To be sure verified also that the same server works OK with 
Synthesis SyncML PRO Client for Android version 2.3.2 on ZTE Blade.




_______________________________________________
os-libsynthesis mailing list
os-libsynthesis-zhcxFSZdvaOWpB8AXVHUkA< at >public.gmane.org
http://lists.synthesis.ch/mailman/listinfo/os-libsynthesis

Re: scripts + datastore

Patrick Ohly — 2012-05-02T14:14:28

Thanks, that worked.

Re: scripts + datastore

Lukas Zeller — 2012-04-27T14:27:35

Hello Patrick,

On Apr 25, 2012, at 15:11 , Patrick Ohly wrote:


The problem is that CTCap is not necessarily tied to a datastore. It is since SyncML 1.2, but wasn't before. That's also the reason why getRelatedDatastore() can be NULL. It is also NULL when using a type from a script with the MAKETEXTWITHPROFILE et. al. functions.


<insert English word for "Jein">. The datatype context indeed exists only once per type, so the script variables exist only once.
However, the init script might be called more than once if multiple datastores are using the same type. The TScriptContext object will be the same, but script functions that use fDsP (see below) can return different information. So using these in the initscript usually makes no sense.


For getting the local datastore related to a particular script invocation, there is

  TLocalEngineDS *related = static_cast<TMultiFieldItemType *>(aFuncContextP->getCallerContext())->fDsP;

fDsP is one of several variables I'd call "current type usage context", fCurrentSyncOp which feeds the SYNCOP() script function is another one of them (See multifielitemtype.h Line 202 ff).


from fDsP you'd get the pointer to the local datastore (TLocalEngineDS *).

So to reach the remote datastore from a given TMultiFieldItem (which you certainly have at comparescript), I'd rather use

  yourMultiFieldItem->getRemoteItemType->getRelatedDatastore()

to get to the datastore that has defined that item's remote type. As said, in SyncML 1.1/1.0 cases you'd get NULL back because the devInf does not associate types with datastores at all. But I'd assume your extension does not have to work below 1.2, so that'll be no problem.

Best Regards,

Lukas

scripts + datastore

Patrick Ohly — 2012-04-25T13:11:07

Hello!

I am trying to solve one issue in SyncEvolution: when trying to find
pairs, it needs to know on a per-datastore basis whether both remote and
local storage have truly unique UID/RECURRENCE-ID that can be relied
upon (iCalendar 2.0 semantic).

So far, I am using a compare script for that, but it has to make
assumptions about the peer. To overcome that I added code that allows
clients to add SyncCap entries to the CTCap (similar to the "can restart
flag"). This information is stored at the receiving end in the
TSyncDataStore base class by the TRemoteDataStore while parsing the
SyncCap (again, very similar to "fCanRestart").

But now my problem is: how can the compare script access that
information?

It runs inside the "datatype context". Does that mean that all
datastores sharing the same type also share the same context and that
the <initscript> for the type is only invoked once?

The script functions in multifielditemtype.cpp (like SYNCOP()) looked
promising. It's possible to get a pointer to some kind of datastore:

TSyncDataStore *related = static_cast<TMultiFieldItemType *>(aFuncContextP->getCallerContext())->getRelatedDatastore();

But in practice that pointer is always NULL. I wasn't sure anyway
whether I would get the pointer to the local or remote datastore.

Any hints?

Re: Sync server with oracle database

Patrick Ohly — 2012-04-24T08:52:55

It would be pretty hard. The HTTP server in SyncEvolution is written in
Python using the Twisted framework and depends on the D-Bus API provided
by the SyncEvolution core, so one also inherits all the rest of
SyncEvolution (own configuration system, backends, etc.).

For writing one's own server, the Synthesis SDK and server will be
easier.

Re: Sync server with oracle database

Lukas Zeller — 2012-04-23T20:23:54

Hi Zhoulei,

On Apr 23, 2012, at 4:06 , zhou lei wrote:

It depends on how complicated your database schema is. If you can map the fields from the <fieldlist> more or less 1:1 to fields in your database, this is indeed easy to do with libsynthesis. You can do the mapping in the XML config, with no need to code anything in Java.
You'd need to install the ODBC driver for Oracle though, as libsynthesis uses ODBC to connect to databases.

Not based on libsynthesis at this time.

Synthesis still provides a full server as a commercial product, and there are free demo and eval packages of a complete server you can download from their site. The database connection part of these is exactly the same as in opensource libsynthesis, so to check if integration with your Oracle DB works you could use the Synthesis EVAL version.
After that, it'll be a make or buy decision wether you want to license the server from them, or build your own based on libsynthesis. The database connection will be the same.

To make a server out of libsynthesis, what needs to be done outside libsynthesis is the connection to the HTTP transport, and session handling (SyncML session objects must be kept around between HTTP requests until the entire session completes or is aborted).

The opensource SyncEvolution project has done this, however SyncEvolution has quite some complexity of its own so I don't know how easy it would be to use the HTTP transport code from SyncEvolution.

Best Regards,

Lukas Zeller, plan44.ch
luz-DkgZRUgWWJ3tRgLqZ5aouw< at >public.gmane.org - www.plan44.ch

Sync server with oracle database

zhou lei — 2012-04-23T02:06:50

Hi, Lukas

I am working on Funambol server for a week, and it just could not connect
to the oracle db. And I am not good at java, and using maven an ant is not
that easy.
And I was think about that, if using the libsynthesis it could be easy,
dosen't it?
Is there a usefull demo server for linux ?  If there isn't, how could i
make it?

Thanks
regards
-zhoulei
_______________________________________________
os-libsynthesis mailing list
os-libsynthesis-zhcxFSZdvaOWpB8AXVHUkA< at >public.gmane.org
http://lists.synthesis.ch/mailman/listinfo/os-libsynthesis

Re: The sync works now. But some other problemsabout the set value.

Lukas Zeller — 2012-04-01T13:14:54

Hi Zhoulei,

On Apr 1, 2012, at 4:16 , zhou lei wrote:


Glad to hear it works now!


The TEL_FLAGS is just an integer field used as a bitmap to create the TYPE parameter. So bit 0 set will add HOME, bit 1 WORK etc.

So to make a TEL;TYPE=WORK:123456789 telephone number (all three the same in this sample), you would something like:

     // - strings in an array
     sInt32 telFieldID = [aItemKey valueIDByName:"TEL"];
     sInt32 telFlagsID = [aItemKey valueIDByName:"TEL_FLAGS"];
     for (int i=0; i<3; i++) {
       [aItemKey setStringValueByID:telFieldID arrayIndex:i toValue:< at >"123456789"];
       [aItemKey setIntValueByID:telFieldID arrayIndex:i toValue:(1<<1)]; // set bit 1 to make it a WORK number
     }

The other fields, "TEL_LABEL" and "TEL_ID" are to support the custom label feature of the iOS address book, and also to expose the iOS ID of the array elements. If you have your own address book database, you probably don't need these and you could remove these extra fields from the XML config as well.

Please also have a look at the conversion modes and options around page 81 of the "doc/SySync_config_reference.pdf". Also, on page 86 there is a much simpler example of how to map telephone numbers to a few fixed fields (instead of arrays). Depending on your address book, that might make more sense to implement, rather than using the complex mapping needed for the iOS address book which can hold a variable number of TELs for each contact and has custom labels and IDs.

Best Regards,

Lukas Zeller

The sync works now. But some other problems aboutthe set value.

zhou lei — 2012-04-01T02:16:03

Hi, Lukas

I just try it as what to told me to do, and the client works. Thank you
very much.

For property "TEL" in the vcard, it just has too many enum values, how
could i set the "TEL" value with its enum flags. If only set it by the
setstringvaluebyname, It may use the default one, but i want to set it
myself.

Thanks
Best Regards
-Zhoulei
_______________________________________________
os-libsynthesis mailing list
os-libsynthesis-zhcxFSZdvaOWpB8AXVHUkA< at >public.gmane.org
http://lists.synthesis.ch/mailman/listinfo/os-libsynthesis

Re: os-libsynthesis Digest, Vol 33, Issue 9

Lukas Zeller — 2012-03-31T11:14:19

Hi Zhoulei,

On Mar 31, 2012, at 11:12 , zhou lei wrote:


Exactly. The terms in the plugin are all meant towards the database.


I would really discourage using a mixture of ObjC and parts from the C++ examples. The ObjC wrapper was done exactly because dealing with the fCB and it's members directly is difficult, and you need to do all the memory management on your own.

EXC_BAD_ACCESS is a bus error which is hard to debug, especially as two completely different memory management systems need to cooperate here (ObjC refcounted world with C++/C traditional malloc/free world).

The ObjC wrapper classes however are really simple to use from the ObjC world.

I made a skeleton for the two read* methods to show how to easily access fields from ObjC, without any messing with fCB, and with automatic conversion from NSString (the SettingsKey also gives you convenience methods to access dates as NSDate and integers).


- (TSyError)readNextItemAsKey:(SettingsKey *)aItemKey
  itemIdP:(NSString **)aItemIdP parentIdP:(NSString **)aParentIdP
  statusP:(sInt32 *)aStatusP
  isFirst:(BOOL)aFirst
{
  TSyError sta = LOCERR_OK;

  [self debugOut:[NSString stringWithFormat:< at >"readNextItemAsKey: aFirst=%d", aFirst]];
  // read next item from DB
  if (aFirst) {
    // %%% reset iterator over dataset here
  }
  // get next item
  BOOL found = NO;
  do {
    if (/* %%% no more data items */) {
      *aStatusP = ReadNextItem_EOF;
      break;
    }
    else {
      found = YES;
      // %%% get IDs of records from the database
      //     Note: data is not required at this point, however, if the database is such
      //           that it always reads the data anyway when getting the IDs, the data
      //           CAN be OPTIONALLY read here already (see below)

      NSString *localID = /* %%%% item ID as string */ < at >"dummyID";
      *aItemIdP = localID;

      // %%% find out if it has modified since last time
      if (/* %%% modified since last suspend */)
        *aStatusP = ReadNextItem_Resumed; // changed since last resume (implies changed since last sync also)
      else if (/* %%% modified since last completed sync session */)
        *aStatusP = ReadNextItem_Changed; // changed since last sync (but NOT since last resume)
      else
        *aStatusP = ReadNextItem_Unchanged; // not changed, but caller wants to see all records


      // %%% optionally, you can ready actual item data from the DB here and return it. If you don't deliver
      //     data here, the engine will later call readItemAsKey to get the data

      // %%% just set some sample properties
      // - simple strings
      [aItemKey setStringValueByName:"N_FIRST" toValue:/* dummy first name */ < at >"Theodor"];
      [aItemKey setStringValueByName:"N_LAST" toValue:/* dummy last name */ < at >"Tester"];

      // - strings in an array
      sInt32 telFieldID = [aItemKey valueIDByName:"TEL"];
      for (int i=0; i<3; i++) {
        [aItemKey setStringValueByID:telFieldID arrayIndex:i toValue:/* dummy TEL */ < at >"12345 78 90"];
      }

      // %%% advance iterator to next item (such that next item will be delivered on next call to reasNextItemAsKey
    }
  } while (!found);
  // done
  return sta;
}




- (TSyError)readItemAsKey:(SettingsKey *)aItemKey
  itemID:(NSString *)aItemID parentID:(NSString *)aParentID
{
  TSyError sta = LOCERR_OK;

  [self debugOut:[NSString stringWithFormat:
    < at >"readItemAsKey: itemID=%< at > parentID=%< at >",
    aItemID, aParentID
  ]];

  // %%% read item identified by NSString in aItemID from DB

  if (/* %%% found item with ID aItemID*/) {

    // %%% just set some sample properties
    // - simple strings
    [aItemKey setStringValueByName:"N_FIRST" toValue:/* dummy first name */ < at >"Theodor"];
    [aItemKey setStringValueByName:"N_LAST" toValue:/* dummy last name */ < at >"Tester"];

    // - strings in an array
    sInt32 telFieldID = [aItemKey valueIDByName:"TEL"];
    for (int i=0; i<3; i++) {
      [aItemKey setStringValueByID:telFieldID arrayIndex:i toValue:/* dummy TEL */ < at >"12345 78 90"];
    }

  }
  else {
    // item not found
    sta = DB_NotFound;
  }
  // done
  return sta;
}



Best Regards,

Lukas

PS: please make sure to Cc: your replies to the mailing list (Synthesis <os-libsynthesis-zhcxFSZdvaOWpB8AXVHUkA< at >public.gmane.org>) as well, and not only to me, so everyone on the list can follow the conversation.

Re: os-libsynthesis Digest, Vol 33, Issue 9

Lukas Zeller — 2012-03-29T09:32:59

Hi Zhoulei,

On Mar 29, 2012, at 5:45 , zhou lei wrote:

That's correct. However, I tried it myself and as you found, there's still that Error 20010, which means that something is wrong in the XML config.
Unfortunately, the sample app did not output the config error messages to the console as it should have. I fixed this, please see the lastest commit in the luz branch on gitorious (the config variable "conferrpath" must be set to "console"). With this, the XCode debug console shows what is the problem:

Fatal: Module does not understand params passed in <plugin_params>

This is because the sample uses the <datafilepath> <plugin_param>, which is specific to the SDK_textdb plugin, and is not understood by the dummy plugins. So just comment out or remove the entire <plugin_param>, and the sync engine will initialize correctly.

In the same commit, I also added a line to enable syncml engine logs to tmp/sysynclogs for DEBUG builds, so it is easier to get started with the sample and see what the SyncML engine is doing.

The prefs_path just returns the default directory for the platform to store preferences, so you can use it in the XML config or your app to avoid hard-coded paths.

You just need to set the <sqlitefile> to a path where your SQLite database is. You could use the $(prefs_path) variable to specifiy that path relative to the default preferences location, but you can also use a absolute path. The SyncMLClient class defines a config variable called $(sandbox) to contain the App's sandbox directory, because that's usually the starting point you need.

So usually you would define the SQLlite file like:

<sqlitefile expand="yes">$(sandbox)/Library/mydatafile.sqlitedb</sqlitefile>

The entire point in libsynthesis is that you can adapt it to your own databases.
If the sync should be with one of the iOS built-in data sources, there are the (quite complex) commerical plugins for iOS contacts and iOS calendar.

If you want to design your own address book, it's up to you to design an alternate address book database.

Sync is complex - there's no easy way. SyncML sync is also a niche, and the iOS opensourcing is quite new. I admit that there's no good tutorial yet, but then, this is OpenSource and anyone is welcome to contribute more samples and docs. If I had to write step by step tutorials myself before opensourcing it, libsynthesis wouldn't be opensource yet. What I'm providing is 10 years of condensed SyncML knowhow, in a library that hides a huge amount of complexity from the user, but still admittedly remains non-trivial, and thus needs some diggin in to learn.

The demo as provided does work on iOS, and as you see I try to improve it to make it more accessible and easier to modify. However, I do this unpaid, and writing all that you seem to expect to just be there would take a lot of time. Opensource works by everyone contributing to a project what he or she thinks is missing, not by one party providing everything for everyone else to use for free.

Re: os-libsynthesis Digest, Vol 33, Issue 9

Lukas Zeller — 2012-03-28T15:48:31

Hello,

On Mar 28, 2012, at 5:47 , zhou lei wrote:


It depends on what you want to do. Of course, if you need to get Google contacts, there's no choice. But otherwise, there are many services and software that support SyncML - have a look at the wikipedia article for a extensive list: SyncML Wikipedia article


20010 is a XML parsing error (see doc/SySync_config_reference.pdf, page 200). 


Probably because of the XML error, the engine never gets as far to instantiate the plugins.

Best Regards,

Lukas Zeller, plan44.ch
luz-DkgZRUgWWJ3tRgLqZ5aouw< at >public.gmane.org - www.plan44.ch

Re: os-libsynthesis Digest, Vol 33, Issue 9

zhou lei — 2012-03-28T03:47:32

Hi, Lukas

If the google sync is not the good one,  which sync server would be better?
If i set the plugin_module to "iPhone_dbplugin1" the client get a 20010
error code.why?
You told me that just modify the code in the sample_dbplugin1.mm.,like "
readItemAsKey". But I found out that, the functions would never been called
in the class of "SamplePluginDB1", even the class "SamplePluginDB1" never
init by the engine.

Thanks
Regards
-Zhoulei

2012/3/23 <os-libsynthesis-request-zhcxFSZdvaOWpB8AXVHUkA< at >public.gmane.org>

_______________________________________________
os-libsynthesis mailing list
os-libsynthesis-zhcxFSZdvaOWpB8AXVHUkA< at >public.gmane.org
http://lists.synthesis.ch/mailman/listinfo/os-libsynthesis

Re: os-libsynthesis Digest, Vol 33, Issue 6

Lukas Zeller — 2012-03-22T15:11:40

Hi Zhoulei,

On Mar 19, 2012, at 3:57 , zhou lei wrote:


Be careful and don't expect too much, Google contact sync is one of the less stellar SyncML implementations :-(


If you use SQLite, you don't need to write your own plugin. libsynthesis has built-in SQLite3 interface, all you need is creating a so-called mapping between the <fields> in the <fieldlist> and your actual database fields. This is done in the <fieldmap> section of the <datastore> in the XML config.

Have a look at  /src/sysync_SDK/configs/sunbird_client.xml, this is a sample of an interface to a SQLite3 backend. The sample looks a bit complicated because of the large scripts handling all the special cases with exceptions etc., but for a plain contact database you probably will not need any scripts at all, so just a few lines of <map> definitions will do.


All you need to do is filling actual DB access code into the methods in sample_dbplugin1.mm that have a comment with //%%% todo, starting with startDataReadWithLastToken.

The wrapper code handles all the rest, instantiates the module and database contexts, and calls the methods you find in sample_dbplugin1.mm.

Best Regards,

Lukas Zeller, plan44.ch
luz-DkgZRUgWWJ3tRgLqZ5aouw< at >public.gmane.org - www.plan44.ch

Re: what's deference between dbplugin for cocoaand for cpp

Lukas Zeller — 2012-03-22T15:09:12

Hi Zhoulei,

On Mar 20, 2012, at 10:31 , zhou lei wrote:


This is the C++ branch of things, it is not relevant for iOS (except maybe for general understanding of how the library works on other platforms).


dbplugin_cocoa.m is the wrapper code that handles the somewhat tricky interface between C and ObjC for you. No need to edit this.

The actual plugin code to write will go into sample_dbplugin1.mm (2,3,4...).

All you need to do is implementing the following methods:

- (TSyError)startDataReadWithLastToken:(cAppCharP)aLastToken andResumeToken:(cAppCharP)aResumeToken;

- (TSyError)readNextItemAsKey:(SettingsKey *)aItemKey
  itemIdP:(NSString **)aItemIdP parentIdP:(NSString **)aParentIdP
  statusP:(sInt32 *)aStatusP
  isFirst:(BOOL)aFirst;

- (TSyError)readItemAsKey:(SettingsKey *)aItemKey
  itemID:(NSString *)aItemID parentID:(NSString *)aParentID;

- (TSyError)endDataRead;

- (TSyError)startDataWrite;

- (TSyError)insertItemAsKey:(SettingsKey *)aItemKey
  parentID:(NSString *)aParentID newItemIdP:(NSString **)aNewItemIdP;

- (TSyError)updateItemAsKey:(SettingsKey *)aItemKey
  itemIdP:(NSString **)aItemIdP parentIdP:(NSString **)aParentIdP;

- (TSyError)deleteItem:(NSString *)aItemID parentID:(NSString *)aParentID;

- (TSyError)endDataWriteWithSuccess:(BOOL)aSuccess andNewToken:(NSString **)aNewTokenP;

...plus maybe some of the optional methods if you have advanced features like filtering (but probably not to start with).

These are semantically 1:1 representations in ObjC of the functions you find described in more detail in doc/SDK_manual.pdf and also in the C++ samples. Because of the work the wrapper code does for you, it is only a small subset of what the C plugin ABI consists of. Things like module/db context creation/deletion is done in the wrapper.

One important note: the Cocoa wrapper code only uses the "AsKey" variants from the plugin API. This means that rather than passing items as text strings, a SettingsKey object is passed, on which you can call methods like stringValueByName: / setStringValueByName:toValue: to access individual fields (see SettingsKey.h for all available access methods). Note that this is the same mechanism as for accessing settings, and you'll find examples for SettingsKey usage in the sample iOS app.

Best Regards,

Lukas Zeller, plan44.ch
luz-DkgZRUgWWJ3tRgLqZ5aouw< at >public.gmane.org - www.plan44.ch

what's deference between dbplugin for cocoa andfor cpp

zhou lei — 2012-03-20T09:31:35

Hi all

We can find "snowwhite" in the doc of the libsynthesis, and in the file
named "dbapi.cpp" we can find it too. And from the demo for IOS, We can
find out that, in cocoa, the lib would using the code in
"dbplugin_cocoa.m". There I found the c functions, like
Module_createContext, and the class snowwhite has these functions too. So I
just think about that could I modefy the dbplugin in the ios demo make it
works like "snowwhite" in cpp. But I cant find out want the session means
in the "snowwhite", and in the dbplugin_cocoa there is a function named
"Session_CreateContext", but do nothing.

Module_CreateContext create the new pluginModule, and init the db with
newpluinDBWithName, but how to init a session. Could anyone can give a
usefull dbplugin?

Thanks
Regards
-Zhoulei
_______________________________________________
os-libsynthesis mailing list
os-libsynthesis-zhcxFSZdvaOWpB8AXVHUkA< at >public.gmane.org
http://lists.synthesis.ch/mailman/listinfo/os-libsynthesis