Re: RESTful Toggle

"Erik Wilde [email protected] [rest-discuss]" <[email protected]> Wed, 09 Jul 2014 18:29:13 +0200
Newsgroups gmane.comp.web.services.rest
Message-ID <[email protected]>
--lxtFhxWGVLKwes2B34sU0OIvF-0wQWXxyQ1SzKY
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

+1: as long as you're resource-oriented (meaning you're POSTing to the 
resource to be toggled, rather than a general toggle-whatever-service), 
everything is fine.

cheers,

dret.

On 2014-07-09, 18:02 , Keith P Hassen wrote:
> Definitely not a departure, as Erik mentioned I think there is a common
> misconception around the use of POST (it offers no guarantees).  You
> wouldn't need to POST to /command, rather, you would POST to
> /togglablethingy with a body of, for example, "toggle=true".
>
> K
>
>
>
> On Wed, Jul 9, 2014 at 11:47 AM, 'Simpson, Robby (GE Energy Management)'
> [email protected] <mailto:[email protected]> [rest-discuss]
> <[email protected]
> <mailto:[email protected]>> wrote:
>
>     __
>
>     Hi Erik!
>
>
>
>     On 7/9/14, 11:39 AM, "Erik Wilde" <[email protected]
>     <mailto:[email protected]>> wrote:
>
>      >hello robby.
>      >
>      >On 2014-07-09, 17:29 , 'Simpson, Robby (GE Energy Management)'
>      >[email protected] <mailto:[email protected]> [rest-discuss]
>     wrote:
>      >> This particular issue has arisen in the design of home automation
>      >>systems. Specifically, I'm working in a standards body (the ZigBee
>      >>Alliance) that has classically used a binary protocol that does not
>      >>really adhere to any true architectural design (IMHO). I've been
>      >>engaged in work that started in ZigBee and has now moved to IEEE
>      >>(2030.5) that (attempts to) rigidly stick to a RESTful HTTP
>     design. One
>      >>request that has come up is to port toggle switch capability to this
>      >>standard. Home automation manufacturers have actually implemented
>      >>toggle switches this way in the past (see
>      >>http://zigbee.org/Products/ByStandard/ZigBeeHomeAutomation.aspx).
>      >
>      >it sounds like the scenario we were talking about, that all you
>     want is
>      >to tell the resource to "reverse its state". in this case, i'd POST a
>      >body that represents this request, in whatever serialization you
>     happen
>      >to prefer. the resource toggles. everybody's happy.
>
>     OK. Still seems like a bit of a departure from typical RESTful
>     interfaces
>     I've seen and has the potential to be a catch-all tunnel for RPC-style
>     requests.
>
>     E.g.:
>     /command, where one could POST all sorts of commands like "toggle."
>
>
>      >but i am confused because you wrote earlier that you were concerned
>      >about race conditions. which seems to imply that instead of just
>      >toggling, you're also assuming that you're "toggling *from* some
>     state".
>      >but that wouldn't be the "blind toggle" we discussed. could you
>     clarify
>      >a bit how exactly the operation that you're trying to design is
>     defined?
>
>     Apologies, a blind toggle is what is desired. As it currently works, in
>     the current binary protocol, a button press on a toggle switch simply
>     sends a "toggle" command.
>
>
>      >
>      >cheers,
>      >
>      >dret.
>      >
>      >--
>      >erik wilde | mailto:[email protected] <mailto:[email protected]> -
>     tel:+1-510-2061079 <tel:%2B1-510-2061079> |
>      > | UC Berkeley - School of Information (ISchool) |
>      > | http://dret.net/netdret http://twitter.com/dret |
>
>     
>
>

-- 
erik wilde | mailto:[email protected]  -  tel:+1-510-2061079 |
            | UC Berkeley  -  School of Information (ISchool) |
            | http://dret.net/netdret http://twitter.com/dret |

--lxtFhxWGVLKwes2B34sU0OIvF-0wQWXxyQ1SzKY
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: 7bit




<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
</head>






 
<body style="background-color: #fff;">
<span style="display:none">&nbsp;</span>

<!--~-|**|PrettyHtmlStartT|**|-~-->
<div id="ygrp-mlmsg" style="position:relative;">
  <div id="ygrp-msg" style="z-index: 1;">
<!--~-|**|PrettyHtmlEndT|**|-~-->

    <div id="ygrp-text" >
      
      
      <p>&#43;1: as long as you&#39;re resource-oriented (meaning you&#39;re POSTing to the <br>
resource to be toggled, rather than a general toggle-whatever-service), <br>
everything is fine.<br>
<br>
cheers,<br>
<br>
dret.<br>
<br>
On 2014-07-09, 18:02 , Keith P Hassen wrote:<br>
&gt; Definitely not a departure, as Erik mentioned I think there is a common<br>
&gt; misconception around the use of POST (it offers no guarantees).  You<br>
&gt; wouldn&#39;t need to POST to /command, rather, you would POST to<br>
&gt; /togglablethingy with a body of, for example, &quot;toggle=true&quot;.<br>
&gt;<br>
&gt; K<br>
&gt;<br>
&gt;<br>
&gt;<br>
&gt; On Wed, Jul 9, 2014 at 11:47 AM, &#39;Simpson, Robby (GE Energy Management)&#39;<br>
&gt; [email protected] &lt;mailto:[email protected]&gt; [rest-discuss]<br>
&gt; &lt;[email protected]<br>
&gt; &lt;mailto:[email protected]&gt;&gt; wrote:<br>
&gt;<br>
&gt;     __<br>
&gt;<br>
&gt;     Hi Erik!<br>
&gt;<br>
&gt;<br>
&gt;<br>
&gt;     On 7/9/14, 11:39 AM, &quot;Erik Wilde&quot; &lt;[email protected]<br>
&gt;     &lt;mailto:[email protected]&gt;&gt; wrote:<br>
&gt;<br>
&gt;      &gt;hello robby.<br>
&gt;      &gt;<br>
&gt;      &gt;On 2014-07-09, 17:29 , &#39;Simpson, Robby (GE Energy Management)&#39;<br>
&gt;      &gt;[email protected] &lt;mailto:[email protected]&gt; [rest-discuss]<br>
&gt;     wrote:<br>
&gt;      &gt;&gt; This particular issue has arisen in the design of home automation<br>
&gt;      &gt;&gt;systems. Specifically, I&#39;m working in a standards body (the ZigBee<br>
&gt;      &gt;&gt;Alliance) that has classically used a binary protocol that does not<br>
&gt;      &gt;&gt;really adhere to any true architectural design (IMHO). I&#39;ve been<br>
&gt;      &gt;&gt;engaged in work that started in ZigBee and has now moved to IEEE<br>
&gt;      &gt;&gt;(2030.5) that (attempts to) rigidly stick to a RESTful HTTP<br>
&gt;     design. One<br>
&gt;      &gt;&gt;request that has come up is to port toggle switch capability to this<br>
&gt;      &gt;&gt;standard. Home automation manufacturers have actually implemented<br>
&gt;      &gt;&gt;toggle switches this way in the past (see<br>
&gt;      &gt;&gt;http://zigbee.org/Products/ByStandard/ZigBeeHomeAutomation.aspx).<br>
&gt;      &gt;<br>
&gt;      &gt;it sounds like the scenario we were talking about, that all you<br>
&gt;     want is<br>
&gt;      &gt;to tell the resource to &quot;reverse its state&quot;. in this case, i&#39;d POST a<br>
&gt;      &gt;body that represents this request, in whatever serialization you<br>
&gt;     happen<br>
&gt;      &gt;to prefer. the resource toggles. everybody&#39;s happy.<br>
&gt;<br>
&gt;     OK. Still seems like a bit of a departure from typical RESTful<br>
&gt;     interfaces<br>
&gt;     I&#39;ve seen and has the potential to be a catch-all tunnel for RPC-style<br>
&gt;     requests.<br>
&gt;<br>
&gt;     E.g.:<br>
&gt;     /command, where one could POST all sorts of commands like &quot;toggle.&quot;<br>
&gt;<br>
&gt;<br>
&gt;      &gt;but i am confused because you wrote earlier that you were concerned<br>
&gt;      &gt;about race conditions. which seems to imply that instead of just<br>
&gt;      &gt;toggling, you&#39;re also assuming that you&#39;re &quot;toggling *from* some<br>
&gt;     state&quot;.<br>
&gt;      &gt;but that wouldn&#39;t be the &quot;blind toggle&quot; we discussed. could you<br>
&gt;     clarify<br>
&gt;      &gt;a bit how exactly the operation that you&#39;re trying to design is<br>
&gt;     defined?<br>
&gt;<br>
&gt;     Apologies, a blind toggle is what is desired. As it currently works, in<br>
&gt;     the current binary protocol, a button press on a toggle switch simply<br>
&gt;     sends a &quot;toggle&quot; command.<br>
&gt;<br>
&gt;<br>
&gt;      &gt;<br>
&gt;      &gt;cheers,<br>
&gt;      &gt;<br>
&gt;      &gt;dret.<br>
&gt;      &gt;<br>
&gt;      &gt;--<br>
&gt;      &gt;erik wilde | mailto:[email protected] &lt;mailto:[email protected]&gt; -<br>
&gt;     tel:&#43;1-510-2061079 &lt;tel:%2B1-510-2061079&gt; |<br>
&gt;      &gt; | UC Berkeley - School of Information (ISchool) |<br>
&gt;      &gt; | http://dret.net/netdret http://twitter.com/dret |<br>
&gt;<br>
&gt;     <br>
&gt;<br>
&gt;<br>
<br>
-- <br>
erik wilde | mailto:[email protected]  -  tel:&#43;1-510-2061079 |<br>
            | UC Berkeley  -  School of Information (ISchool) |<br>
            | http://dret.net/netdret http://twitter.com/dret |<br>
</p>

    </div>
     

    <!--~-|**|PrettyHtmlStart|**|-~-->
    <div style="color: #fff; height: 0;">__._,_.___</div>

          
  
 

    
    <div style="clear:both"> </div>

    <div id="fromDMARC" style="margin-top: 10px;">
        <hr style="height:2px ; border-width:0; color:#E3E3E3; background-color:#E3E3E3;">
        Posted by: Erik Wilde &lt;[email protected]&gt;        <hr style="height:2px ; border-width:0; color:#E3E3E3; background-color:#E3E3E3;">
     </div>
    <div style="clear:both"> </div>

    <table cellspacing=4px style="margin-top: 10px; margin-bottom: 10px; color: #2D50FD;">
      <tbody>
        <tr>
          <td style="font-size: 12px; font-family: arial; font-weight: bold; padding: 7px 5px 5px;"  >
                          <a style="text-decoration: none; color: #2D50FD" href="https://groups.yahoo.com/neo/groups/rest-discuss/conversations/messages/19678;_ylc=X3oDMTJxNjVnMnJ2BF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BG1zZ0lkAzE5Njc4BHNlYwNmdHIEc2xrA3JwbHkEc3RpbWUDMTQwNDkyMzM2MQ--?act=reply&messageNum=19678">Reply via web post</a>
                      </td>
          <td>&bull;</td>
          <td style="font-size: 12px; font-family: arial; padding: 7px 5px 5px;" >
            <a href="mailto:[email protected]?subject=Re%3A%20%5Brest-discuss%5D%20RESTful%20Toggle" style="text-decoration: none; color: #2D50FD;">
               Reply to sender            </a>
          </td>
          <td>&bull;</td>
          <td style="font-size: 12px; font-family: arial; padding: 7px 5px 5px;">
            <a href="mailto:[email protected]?subject=Re%3A%20%5Brest-discuss%5D%20RESTful%20Toggle" style="text-decoration: none; color: #2D50FD">
              Reply to group            </a>
          </td>
          <td>&bull;</td>
          <td style="font-size: 12px; font-family: arial; padding: 7px 5px 5px;" >
            <a href="https://groups.yahoo.com/neo/groups/rest-discuss/conversations/newtopic;_ylc=X3oDMTJlMDFxYnFwBF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BHNlYwNmdHIEc2xrA250cGMEc3RpbWUDMTQwNDkyMzM2MQ--" style="text-decoration: none; color: #2D50FD">Start a New Topic</a>
          </td>
          <td>&bull;</td>
          <td style="font-size: 12px; font-family: arial; padding: 7px 5px 5px;color: #2D50FD;" >
                            <a href="https://groups.yahoo.com/neo/groups/rest-discuss/conversations/topics/19657;_ylc=X3oDMTM2Njlma2FkBF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BG1zZ0lkAzE5Njc4BHNlYwNmdHIEc2xrA3Z0cGMEc3RpbWUDMTQwNDkyMzM2MQR0cGNJZAMxOTY1Nw--" style="text-decoration: none; color: #2D50FD;">Messages in this topic</a>
                (22)
                      </td>
        </tr>
      </tbody>
    </table>

        

<!------- Start Nav Bar ------>




 

<!-- |**|begin egp html banner|**| -->
<div id="ygrp-vital" style="background-color: #f2f2f2; font-family: Verdana; font-size: 10px; margin-bottom: 10px; padding: 10px;">

    <span id="vithd" style="font-weight: bold; color: #333; text-transform: uppercase; "><a href="https://groups.yahoo.com/neo/groups/rest-discuss/info;_ylc=X3oDMTJlNmQ5aTQ1BF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BHNlYwN2dGwEc2xrA3ZnaHAEc3RpbWUDMTQwNDkyMzM2MQ--" style="text-decoration: none;">Visit Your Group</a></span>

     <ul style="list-style-type: none; margin: 0; padding: 0; display: inline;">
            <li style="border-right: 1px solid #000; font-weight: 700; display: inline; padding: 0 5px; margin-left: 0;">
      <span class="cat"><a href="https://groups.yahoo.com/neo/groups/rest-discuss/members/all;_ylc=X3oDMTJmOGRyNTJlBF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BHNlYwN2dGwEc2xrA3ZtYnJzBHN0aW1lAzE0MDQ5MjMzNjE-" style="text-decoration: none;">New Members</a></span>
      <span class="ct" style="color: #ff7900;">2</span>
    </li>
                                              </ul>
  </div>


<div id="ft" style="font-family: Arial; font-size: 11px; margin-top: 5px; padding: 0 2px 0 0; clear: both;">
  <a href="https://groups.yahoo.com/neo;_ylc=X3oDMTJka2c4amxwBF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BHNlYwNmdHIEc2xrA2dmcARzdGltZQMxNDA0OTIzMzYx" style="float: left;"><img src="http://l.yimg.com/ru/static/images/yg/img/email/new_logo/logo-groups-137x15.png" height="15" width="137" alt="Yahoo! Groups" style="border: 0;"/></a>
  <div style="color: #747575; float: right;"> &bull; <a href="https://info.yahoo.com/privacy/us/yahoo/groups/details.html" style="text-decoration: none;">Privacy</a> &bull; <a href="mailto:[email protected]?subject=Unsubscribe" style="text-decoration: none;">Unsubscribe</a> &bull; <a href="https://info.yahoo.com/legal/us/yahoo/utos/terms/" style="text-decoration: none;">Terms of Use</a> </div>
</div>
<br>

<!-- |**|end egp html banner|**| -->

  </div> <!-- ygrp-msg -->

 
  <!-- Sponsor -->
  <!-- |**|begin egp html banner|**| -->
  <div id="ygrp-sponsor" style="width:160px; float:right; clear:none; margin:0 0 25px 0; background: #fff;">

<!-- Start Recommendations -->
<div id="ygrp-reco">
     </div>
<!-- End Recommendations -->



  </div>   <!-- |**|end egp html banner|**| -->

  <div style="clear:both; color: #FFF; font-size:1px;">.</div>
</div>

  <img src="http://geo.yahoo.com/serv?s=97359714/grpId=4319255/grpspId=1705701014/msgId=19678/stime=1404923361" width="1" height="1"> <br>

<img src="http://y.analytics.yahoo.com/fpc.pl?ywarid=515FB27823A7407E&a=10001310322279&js=no&resp=img" width="1" height="1"> 

<div style="color: #fff; height: 0;">__,_._,___</div>
<!--~-|**|PrettyHtmlEnd|**|-~-->

</body>

<!--~-|**|PrettyHtmlStart|**|-~-->
<head>
  <style type="text/css">
  <!--
  #ygrp-mkp {
  border: 1px solid #d8d8d8;
  font-family: Arial;
  margin: 10px 0;
  padding: 0 10px;
}

#ygrp-mkp hr {
  border: 1px solid #d8d8d8;
}

#ygrp-mkp #hd {
  color: #628c2a;
  font-size: 85%;
  font-weight: 700;
  line-height: 122%;
  margin: 10px 0;
}

#ygrp-mkp #ads {
  margin-bottom: 10px;
}

#ygrp-mkp .ad {
  padding: 0 0;
}

#ygrp-mkp .ad p {
  margin: 0;
}

#ygrp-mkp .ad a {
  color: #0000ff;
  text-decoration: none;
}
  #ygrp-sponsor #ygrp-lc {
  font-family: Arial;
}

#ygrp-sponsor #ygrp-lc #hd {
  margin: 10px 0px;
  font-weight: 700;
  font-size: 78%;
  line-height: 122%;
}

#ygrp-sponsor #ygrp-lc .ad {
  margin-bottom: 10px;
  padding: 0 0;
}

  #actions {
    font-family: Verdana;
    font-size: 11px;
    padding: 10px 0;
  }

  #activity {
    background-color: #e0ecee;
    float: left;
    font-family: Verdana;
    font-size: 10px;
    padding: 10px;
  }

  #activity span {
    font-weight: 700;
  }

  #activity span:first-child {
    text-transform: uppercase;
  }

  #activity span a {
    color: #5085b6;
    text-decoration: none;
  }

  #activity span span {
    color: #ff7900;
  }

  #activity span .underline {
    text-decoration: underline;
  }

  .attach {
    clear: both;
    display: table;
    font-family: Arial;
    font-size: 12px;
    padding: 10px 0;
    width: 400px;
  }

  .attach div a {
    text-decoration: none;
  }

  .attach img {
    border: none;
    padding-right: 5px;
  }

  .attach label {
    display: block;
    margin-bottom: 5px;
  }

  .attach label a {
    text-decoration: none;
  }
  
  blockquote {
    margin: 0 0 0 4px;
  }

  .bold {
    font-family: Arial;
    font-size: 13px;
    font-weight: 700;
  }

  .bold a {
    text-decoration: none;
  }

  dd.last p a {
    font-family: Verdana;
    font-weight: 700;
  }

  dd.last p span {
    margin-right: 10px;
    font-family: Verdana;
    font-weight: 700;
  }

  dd.last p span.yshortcuts {
    margin-right: 0;
  }

  div.attach-table div div a {
    text-decoration: none;
  }

  div.attach-table {
    width: 400px;
  }

  div.file-title a, div.file-title a:active, div.file-title a:hover, div.file-title a:visited {
    text-decoration: none;
  }

  div.photo-title a, div.photo-title a:active, div.photo-title a:hover, div.photo-title a:visited {
    text-decoration: none;
  }

  div#ygrp-mlmsg #ygrp-msg p a span.yshortcuts {
    font-family: Verdana;
    font-size: 10px;
    font-weight: normal;
  }

  .green {
    color: #628c2a;
  }

  .MsoNormal {
    margin: 0 0 0 0;
  }

  o {
    font-size: 0;
  }

  #photos div {
    float: left;
    width: 72px;
  }

  #photos div div {
    border: 1px solid #666666;
    height: 62px;
    overflow: hidden;
    width: 62px;
  }

  #photos div label {
    color: #666666;
    font-size: 10px;
    overflow: hidden;
    text-align: center;
    white-space: nowrap;
    width: 64px;
  }

  #reco-category {
    font-size: 77%;
  }

  #reco-desc {
    font-size: 77%;
  }

  .replbq {
    margin: 4px;
  }

  #ygrp-actbar div a:first-child {
   /* border-right: 0px solid #000;*/
    margin-right: 2px;
    padding-right: 5px;
  }

  #ygrp-mlmsg {
    font-size: 13px;
    font-family: Arial, helvetica,clean, sans-serif;
    *font-size: small;
    *font: x-small;
  }

  #ygrp-mlmsg table {
    font-size: inherit;
    font: 100%;
  }

  #ygrp-mlmsg select, input, textarea {
    font: 99% Arial, Helvetica, clean, sans-serif;
  }

  #ygrp-mlmsg pre, code {
    font:115% monospace;
    *font-size:100%;
  }

  #ygrp-mlmsg * {
    line-height: 1.22em;
  }

  #ygrp-mlmsg #logo {
    padding-bottom: 10px;
  }


  #ygrp-msg p a {
    font-family: Verdana;
  }

  #ygrp-msg p#attach-count span {
    color: #1E66AE;
    font-weight: 700;
  }

  #ygrp-reco #reco-head {
    color: #ff7900;
    font-weight: 700;
  }

  #ygrp-reco {
    margin-bottom: 20px;
    padding: 0px;
  }

  #ygrp-sponsor #ov li a {
    font-size: 130%;
    text-decoration: none;
  }

  #ygrp-sponsor #ov li {
    font-size: 77%;
    list-style-type: square;
    padding: 6px 0;
  } 

  #ygrp-sponsor #ov ul {
    margin: 0;
    padding: 0 0 0 8px;
  }

  #ygrp-text {
    font-family: Georgia;
  }

  #ygrp-text p {
    margin: 0 0 1em 0;
  }

  #ygrp-text tt {
    font-size: 120%;
  }

  #ygrp-vital ul li:last-child {
    border-right: none !important; 
  } 
  -->
  </style>
</head>

<!--~-|**|PrettyHtmlEnd|**|-~-->
</html>
<!-- end group email -->


--lxtFhxWGVLKwes2B34sU0OIvF-0wQWXxyQ1SzKY--