Re: RESTful Toggle

"Nick Gall [email protected] [rest-discuss]" <[email protected]> Wed, 9 Jul 2014 11:14:34 -0400
Newsgroups gmane.comp.web.services.rest
Message-ID <CA+xhAPWQ5iTHvZ-ykBDYGThRwNTY0JT5E2N8WMhXrYityffssQ@mail.gmail.com>
--001a11345e36a39db904fdc42b7e
Content-Type: text/plain; charset=UTF-8

Robby, I'd like to know more about the real world need for such an API.
Sure, mechanical light switches DID work this way, but do home automation
systems really offer a "toggle"? I'm trying to imagine why I would ever
want to simply change the state of the lighting in my room, without caring
if the result was lights on or lights off. I can't.

So are you programming a home automation system? If so, do you really need
toggle, given my observation above?

Or is this just a hypothetical question about the generic behavior of
toggle and how it maps to REST? If so, then it kind of feels like the
perennial, "Can REST do THIS?" questions that skeptics of REST would lob
from time to time in the good old REST v WS-STAR WARS days. It kind of
reminds me of the old chestnut, "How can I do two-phase commit in REST?"

Or is your need for toggle behavior truly needed in some other actual
domain? If so, could you please tell us a bit more about the domain and
it's REAL need for toggle behavior. With such context in mind, we can
perhaps help you better map it into a RESTful API.

Thanks.

-- Nick

Nick Gall
Phone: +1.781.325.8370
Other Contact Info: http://bit.ly/nickgall


On Tue, Jul 8, 2014 at 5:28 PM, 'Simpson, Robby (GE Energy Management)'
[email protected] [rest-discuss] <[email protected]>
wrote:

> Hi,
>
>
> I've been scratching my head over this one for a while and am hoping I can
> get some help.
>
>
> Imagine a light switch with one simple resource: /state , where state can
> be "On" or "Off."
>
>
> One can PUT to /state , changing /state to either "On" or "Off."
> Similarly, a GET to /state will tell you if the light is currently "On" or
> "Off."
>
>
> Where I'm struggling is with a safe "Toggle" mechanism.  That is, if
> /state is "On", change it to "Off" and vice versa.
>
>
> I understand that one solution would be to simply perform a GET on /state
> and then PUT the opposite.  However, I am concerned with both the overhead
> and latency this entails as well as the potential for a race condition
> (what if /state changes between the GET and the PUT?).
>
>
> Any solution I've looked at thus far seems to violate RESTful principles,
> particularly regarding idempotency.  In short, can one safely toggle?
>
>
> Any suggestions?
>
>
> Thanks,
> Robby
>
>
>
>
> ------------------------------------
> Posted by: "Simpson, Robby (GE Energy Management)" <[email protected]>
> ------------------------------------
>
>
> ------------------------------------
>
> Yahoo Groups Links
>
>
>
>

--001a11345e36a39db904fdc42b7e
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable




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






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

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

    <div id=3D"ygrp-text" >
=20=20=20=20=20=20
=20=20=20=20=20=20
      <p><div dir=3D"ltr">Robby, I&#39;d like to know more about the real w=
orld need for such an API. Sure, mechanical light switches DID work this wa=
y, but do home automation systems really offer a &quot;toggle&quot;? I&#39;=
m trying to imagine why I would ever want to simply change the state of the=
 lighting in my room, without caring if the result was lights on or lights =
off. I can&#39;t.<div>

<br></div><div>So are you programming a home automation system? If so, do y=
ou really need toggle, given my observation above?</div><div><br></div><div=
>Or is this just a hypothetical question about the generic behavior of togg=
le and how it maps to REST? If so, then it kind of feels like the perennial=
, &quot;Can REST do THIS?&quot; questions that skeptics of REST would lob f=
rom time to time in the good old REST v WS-STAR WARS days. It kind of remin=
ds me of the old chestnut, &quot;How can I do two-phase commit in REST?&quo=
t;</div>

<div><br></div><div>Or is your need for toggle behavior truly needed in som=
e other actual domain? If so, could you please tell us a bit more about the=
 domain and it&#39;s REAL need for toggle behavior. With such context in mi=
nd, we can perhaps help you better map it into a RESTful API.</div>

<div><br></div><div>Thanks.</div><div><br></div><div>-- Nick</div></div><di=
v class=3D"gmail_extra"><br clear=3D"all"><div><div dir=3D"ltr">Nick Gall<b=
r>Phone: &#43;1.781.325.8370<br>Other Contact Info: <a href=3D"http://bit.l=
y/nickgall" target=3D"_blank">http://bit.ly/nickgall</a></div>

</div>
<br><br><div class=3D"gmail_quote">On Tue, Jul 8, 2014 at 5:28 PM, &#39;Sim=
pson, Robby (GE Energy Management)&#39; <a href=3D"mailto:robby.simpson@ge.=
com">[email protected]</a> [rest-discuss] <span dir=3D"ltr">&lt;<a href=
=3D"mailto:[email protected]" target=3D"_blank">rest-dis=
[email protected]</a>&gt;</span> wrote:<br>

<blockquote class=3D"gmail_quote" style=3D"border-left:1px #ccc solid;">Hi,=
<br>
<br>
<br>
I&#39;ve been scratching my head over this one for a while and am hoping I =
can<br>
get some help.<br>
<br>
<br>
Imagine a light switch with one simple resource: /state , where state can<b=
r>
be &quot;On&quot; or &quot;Off.&quot;<br>
<br>
<br>
One can PUT to /state , changing /state to either &quot;On&quot; or &quot;O=
ff.&quot;<br>
Similarly, a GET to /state will tell you if the light is currently &quot;On=
&quot; or<br>
&quot;Off.&quot;<br>
<br>
<br>
Where I&#39;m struggling is with a safe &quot;Toggle&quot; mechanism. =C2=
=A0That is, if<br>
/state is &quot;On&quot;, change it to &quot;Off&quot; and vice versa.<br>
<br>
<br>
I understand that one solution would be to simply perform a GET on /state<b=
r>
and then PUT the opposite. =C2=A0However, I am concerned with both the over=
head<br>
and latency this entails as well as the potential for a race condition<br>
(what if /state changes between the GET and the PUT?).<br>
<br>
<br>
Any solution I&#39;ve looked at thus far seems to violate RESTful principle=
s,<br>
particularly regarding idempotency. =C2=A0In short, can one safely toggle?<=
br>
<br>
<br>
Any suggestions?<br>
<br>
<br>
Thanks,<br>
Robby<br>
<br>
<br>
<br>
<br>
------------------------------------<br>
Posted by: &quot;Simpson, Robby (GE Energy Management)&quot; &lt;<a href=3D=
"mailto:[email protected]">[email protected]</a>&gt;<br>
------------------------------------<br>
<br>
<br>
------------------------------------<br>
<br>
Yahoo Groups Links<br>
<br>
&lt;*&gt; To visit your group on the web, go to:<br>
=C2=A0 =C2=A0 <a href=3D"http://groups.yahoo.com/group/rest-discuss/" targe=
t=3D"_blank">http://groups.yahoo.com/group/rest-discuss/</a><br>
<br>
&lt;*&gt; Your email settings:<br>
=C2=A0 =C2=A0 Individual Email | Traditional<br>
<br>
&lt;*&gt; To change settings online go to:<br>
=C2=A0 =C2=A0 <a href=3D"http://groups.yahoo.com/group/rest-discuss/join" t=
arget=3D"_blank">http://groups.yahoo.com/group/rest-discuss/join</a><br>
=C2=A0 =C2=A0 (Yahoo! ID required)<br>
<br>
&lt;*&gt; To change settings via email:<br>
=C2=A0 =C2=A0 <a href=3D"mailto:[email protected]">rest-d=
[email protected]</a><br>
=C2=A0 =C2=A0 <a href=3D"mailto:[email protected]">=
[email protected]</a><br>
<br>
&lt;*&gt; To unsubscribe from this group, send an email to:<br>
=C2=A0 =C2=A0 <a href=3D"mailto:[email protected]">r=
[email protected]</a><br>
<br>
&lt;*&gt; Your use of Yahoo Groups is subject to:<br>
=C2=A0 =C2=A0 <a href=3D"https://info.yahoo.com/legal/us/yahoo/utos/terms/"=
 target=3D"_blank">https://info.yahoo.com/legal/us/yahoo/utos/terms/</a><br=
>
<br>
</blockquote></div><br></div>
</p>

    </div>
=20=20=20=20=20

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

=20=20=20=20=20=20=20=20=20=20
=20=20
=20

=20=20=20=20
    <div style=3D"clear:both"> </div>

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

    <table cellspacing=3D4px style=3D"margin-top: 10px; margin-bottom: 10px=
; color: #2D50FD;">
      <tbody>
        <tr>
          <td style=3D"font-size: 12px; font-family: arial; font-weight: bo=
ld; padding: 7px 5px 5px;"  >
                          <a style=3D"text-decoration: none; color: #2D50FD=
" href=3D"https://groups.yahoo.com/neo/groups/rest-discuss/conversations/me=
ssages/19669;_ylc=3DX3oDMTJxNjlvbDM0BF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3J=
wc3BJZAMxNzA1NzAxMDE0BG1zZ0lkAzE5NjY5BHNlYwNmdHIEc2xrA3JwbHkEc3RpbWUDMTQwND=
kxODg5NQ--?act=3Dreply&messageNum=3D19669">Reply via web post</a>
                      </td>
          <td>&bull;</td>
          <td style=3D"font-size: 12px; font-family: arial; padding: 7px 5p=
x 5px;" >
            <a href=3D"mailto:[email protected]?subject=3DRe%3A%20%5Brest=
-discuss%5D%20RESTful%20Toggle" style=3D"text-decoration: none; color: #2D5=
0FD;">
               Reply to sender            </a>
          </td>
          <td>&bull;</td>
          <td style=3D"font-size: 12px; font-family: arial; padding: 7px 5p=
x 5px;">
            <a href=3D"mailto:[email protected]?subject=3DRe%3A%=
20%5Brest-discuss%5D%20RESTful%20Toggle" style=3D"text-decoration: none; co=
lor: #2D50FD">
              Reply to group            </a>
          </td>
          <td>&bull;</td>
          <td style=3D"font-size: 12px; font-family: arial; padding: 7px 5p=
x 5px;" >
            <a href=3D"https://groups.yahoo.com/neo/groups/rest-discuss/con=
versations/newtopic;_ylc=3DX3oDMTJlbWpmZmk5BF9TAzk3MzU5NzE0BGdycElkAzQzMTky=
NTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BHNlYwNmdHIEc2xrA250cGMEc3RpbWUDMTQwNDkxODg5NQ-=
-" style=3D"text-decoration: none; color: #2D50FD">Start a New Topic</a>
          </td>
          <td>&bull;</td>
          <td style=3D"font-size: 12px; font-family: arial; padding: 7px 5p=
x 5px;color: #2D50FD;" >
                            <a href=3D"https://groups.yahoo.com/neo/groups/=
rest-discuss/conversations/topics/19657;_ylc=3DX3oDMTM2bW9ybGsxBF9TAzk3MzU5=
NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BG1zZ0lkAzE5NjY5BHNlYwNmdHI=
Ec2xrA3Z0cGMEc3RpbWUDMTQwNDkxODg5NQR0cGNJZAMxOTY1Nw--" style=3D"text-decora=
tion: none; color: #2D50FD;">Messages in this topic</a>
                (13)
                      </td>
        </tr>
      </tbody>
    </table>

=20=20=20=20=20=20=20=20

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




=20

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

    <span id=3D"vithd" style=3D"font-weight: bold; color: #333; text-transf=
orm: uppercase; "><a href=3D"https://groups.yahoo.com/neo/groups/rest-discu=
ss/info;_ylc=3DX3oDMTJlMG1vMXFqBF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJ=
ZAMxNzA1NzAxMDE0BHNlYwN2dGwEc2xrA3ZnaHAEc3RpbWUDMTQwNDkxODg5NQ--" style=3D"=
text-decoration: none;">Visit Your Group</a></span>

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


<div id=3D"ft" style=3D"font-family: Arial; font-size: 11px; margin-top: 5p=
x; padding: 0 2px 0 0; clear: both;">
  <a href=3D"https://groups.yahoo.com/neo;_ylc=3DX3oDMTJkZmg0djl0BF9TAzk3ND=
c2NTkwBGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BHNlYwNmdHIEc2xrA2dmcARzd=
GltZQMxNDA0OTE4ODk2" style=3D"float: left;"><img src=3D"http://l.yimg.com/r=
u/static/images/yg/img/email/new_logo/logo-groups-137x15.png" height=3D"15"=
 width=3D"137" alt=3D"Yahoo! Groups" style=3D"border: 0;"/></a>
  <div style=3D"color: #747575; float: right;"> &bull; <a href=3D"https://i=
nfo.yahoo.com/privacy/us/yahoo/groups/details.html" style=3D"text-decoratio=
n: none;">Privacy</a> &bull; <a href=3D"mailto:rest-discuss-unsubscribe@yah=
oogroups.com?subject=3DUnsubscribe" style=3D"text-decoration: none;">Unsubs=
cribe</a> &bull; <a href=3D"https://info.yahoo.com/legal/us/yahoo/utos/term=
s/" style=3D"text-decoration: none;">Terms of Use</a> </div>
</div>
<br>

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

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

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

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



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

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

  <img src=3D"http://geo.yahoo.com/serv?s=3D97359714/grpId=3D4319255/grpspI=
d=3D1705701014/msgId=3D19669/stime=3D1404918895" width=3D"1" height=3D"1"> =
<br>

<img src=3D"http://y.analytics.yahoo.com/fpc.pl?ywarid=3D515FB27823A7407E&a=
=3D10001310322279&js=3Dno&resp=3Dimg" width=3D"1" height=3D"1">=20

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

</body>

<!--~-|**|PrettyHtmlStart|**|-~-->
<head>
  <style type=3D"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;
  }
=20=20
  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.fi=
le-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;
  }=20

  #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;=20
  }=20
  -->
  </style>
</head>

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


--001a11345e36a39db904fdc42b7e--