Bulk Collection Manipulation through a REST (RESTful) API

后端 未结 7 696
我寻月下人不归
我寻月下人不归 2020-12-04 06:45

I\'d like some advice on designing a REST API which will allow clients to add/remove large numbers of objects to a collection efficiently.

Via the API, clients need

相关标签:
7条回答
  • 2020-12-04 07:10

    You might want to think of the change task as a resource in itself. So you're really PUT-ing a single object, which is a Bulk Data Update object. Maybe it's got a name, owner, and big blob of CSV, XML, etc. that needs to be parsed and executed. In the case of CSV you might want to also identify what type of objects are represented in the CSV data.

    List jobs, add a job, view the status of a job, update a job (probably in order to start/stop it), delete a job (stopping it if it's running) etc. Those operations map easily onto a REST API design.

    Once you have this in place, you can easily add different data types that your bulk data updater can handle, maybe even mixed together in the same task. There's no need to have this same API duplicated all over your app for each type of thing you want to import, in other words.

    This also lends itself very easily to a background-task implementation. In that case you probably want to add fields to the individual task objects that allow the API client to specify how they want to be notified (a URL they want you to GET when it's done, or send them an e-mail, etc.).

    0 讨论(0)
  • 2020-12-04 07:22

    Best way is :

    Pass Only Id Array of Deletable Objects from Front End Application To Web API
        2. Then You have Two Options: 
           2.1 Web API Way : Find All Collections/Entities using Id arrays and Delete in API , but you need to take care of Dependant entities like Foreign Key Relational Table Data too
         2.2. Database Way : Pass Ids to your database side, find all records in Foreign Key Tables and Primary Key Tables and Delete in same order i.e. F-Key Table records then P-Key Table records
    
    0 讨论(0)
  • 2020-12-04 07:24

    For the POSTs, at least, it seems like you should be able to POST to a list URL and have the body of the request contain a list of new resources instead of a single new resource.

    0 讨论(0)
  • 2020-12-04 07:24

    You could introduce meta-representation of existing collection elements that don't need their entire state transfered, so in some abstract code your update could look like this:

    {existing elements 1-100}
    {new element foo with values "bar", "baz"}
    {existing element 105}
    {new element foobar with values "bar", "foo"}
    {existing elements 110-200}

    Adding (and modifying) elements is done by defining their values, deleting elements is done by not mentioning it the new collection and reordering elements is done by specifying the new order (if order is stored at all).

    This way you can easily represent the entire new collection without having to re-transmit the entire content. Using a If-Unmodified-Since header makes sure that your idea of the content indeed matches the servers idea (so that you don't accidentally remove elements that you simply didn't know about when the request was submitted).

    0 讨论(0)
  • 2020-12-04 07:30

    As far as I understand it, REST means REpresentational State Transfer, so you should transfer the state from client to server.

    If that means too much data going back and forth, perhaps you need to change your representation. A collectionChange structure would work, with a series of deletions (by id) and additions (with embedded full xml Representations), POSTed to a handling interface URL. The interface implementation can choose its own method for deletions and additions server-side.

    The purest version would probably be to define the items by URL, and the collection contain a series of URLs. The new collection can be PUT after changes by the client, followed by a series of PUTs of the items being added, and perhaps a series of deletions if you want to actually remove the items from the server rather than just remove them from that list.

    0 讨论(0)
  • 2020-12-04 07:32

    You should use AtomPub. It is specifically designed for managing collections via HTTP. There might even be an implementation for your language of choice.

    0 讨论(0)
提交回复
热议问题