summaryrefslogtreecommitdiffstats
path: root/_build/static/archives/extend/2014-May/000388.html
diff options
context:
space:
mode:
Diffstat (limited to '_build/static/archives/extend/2014-May/000388.html')
-rw-r--r--_build/static/archives/extend/2014-May/000388.html180
1 files changed, 180 insertions, 0 deletions
diff --git a/_build/static/archives/extend/2014-May/000388.html b/_build/static/archives/extend/2014-May/000388.html
new file mode 100644
index 00000000..0c28ba4d
--- /dev/null
+++ b/_build/static/archives/extend/2014-May/000388.html
@@ -0,0 +1,180 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<HTML>
+ <HEAD>
+ <TITLE> [99s-extend] REST responses
+ </TITLE>
+ <LINK REL="Index" HREF="index.html" >
+ <LINK REL="made" HREF="mailto:extend%40lists.ninenines.eu?Subject=Re%3A%20%5B99s-extend%5D%20REST%20responses&In-Reply-To=%3CCA%2BdV7cTrbQd-widnjH5CjsYum%3DASwax7VxtAUn_9BVONp2MMuA%40mail.gmail.com%3E">
+ <META NAME="robots" CONTENT="index,nofollow">
+ <style type="text/css">
+ pre {
+ white-space: pre-wrap; /* css-2.1, curent FF, Opera, Safari */
+ }
+ </style>
+ <META http-equiv="Content-Type" content="text/html; charset=us-ascii">
+ <LINK REL="Previous" HREF="000386.html">
+ <LINK REL="Next" HREF="000389.html">
+ </HEAD>
+ <BODY BGCOLOR="#ffffff">
+ <H1>[99s-extend] REST responses</H1>
+ <B>Paulo F. Oliveira</B>
+ <A HREF="mailto:extend%40lists.ninenines.eu?Subject=Re%3A%20%5B99s-extend%5D%20REST%20responses&In-Reply-To=%3CCA%2BdV7cTrbQd-widnjH5CjsYum%3DASwax7VxtAUn_9BVONp2MMuA%40mail.gmail.com%3E"
+ TITLE="[99s-extend] REST responses">paulo.ferraz.oliveira at gmail.com
+ </A><BR>
+ <I>Tue May 20 23:41:15 CEST 2014</I>
+ <P><UL>
+ <LI>Previous message: <A HREF="000386.html">[99s-extend] REST responses
+</A></li>
+ <LI>Next message: <A HREF="000389.html">[99s-extend] REST responses
+</A></li>
+ <LI> <B>Messages sorted by:</B>
+ <a href="date.html#388">[ date ]</a>
+ <a href="thread.html#388">[ thread ]</a>
+ <a href="subject.html#388">[ subject ]</a>
+ <a href="author.html#388">[ author ]</a>
+ </LI>
+ </UL>
+ <HR>
+<!--beginarticle-->
+<PRE>Hi, Lo&#239;c.
+
+Thanks for having taken the time to reply. In some of my questions I think
+I didn't explain myself correctly so I'll give it another go.
+
+
+On 20 May 2014 19:46, Lo&#239;c Hoguin &lt;<A HREF="https://lists.ninenines.eu/listinfo/extend">essen at ninenines.eu</A>&gt; wrote:
+
+&gt;<i> Hi,
+</I>&gt;<i>
+</I>&gt;<i>
+</I>&gt;<i> On 05/20/2014 06:27 PM, Paulo F. Oliveira wrote:
+</I>&gt;<i>
+</I>&gt;&gt;<i> Hello.
+</I>&gt;&gt;<i>
+</I>&gt;&gt;<i> First of all, thanks for the great work you've done with cowboy. I've
+</I>&gt;&gt;<i> been using it with a fait amount of success and I'm a fairly new Erlang
+</I>&gt;&gt;<i> developer. I'm mainly interested in the REST &quot;interface&quot; of the
+</I>&gt;&gt;<i> application and its way of doing RESTful things, and I like the way you
+</I>&gt;&gt;<i> did it (what with all the content_types_provided, service_available,
+</I>&gt;&gt;<i> etc. functions). I've tested the way the system reacted to the different
+</I>&gt;&gt;<i> Accept, Content-Type, etc. headers and always got very well-opinionated
+</I>&gt;&gt;<i> responses (406, 415, ...).
+</I>&gt;&gt;<i>
+</I>&gt;&gt;<i> A couple of questions remain though (I'm sorry if they've been asked
+</I>&gt;&gt;<i> already but I've searched the web for answers and read the available
+</I>&gt;&gt;<i> docs and couldn't find them):
+</I>&gt;&gt;<i>
+</I>&gt;&gt;<i> 1. is it expected that, if I use cowboy_req:reply/2 in a GET handler
+</I>&gt;&gt;<i> (coming from content_types_provided), the onresponse/4 hook be called
+</I>&gt;&gt;<i> twice? I guess one is due to the reply and the other one due to the
+</I>&gt;&gt;<i> workflow of the request, but is there a way to prevent the second
+</I>&gt;&gt;<i> execution?
+</I>&gt;&gt;<i>
+</I>&gt;<i>
+</I>&gt;<i> If you reply from a callback you must call {halt, Req, State} to stop
+</I>&gt;<i> processing.
+</I>
+
+Got it!
+
+
+&gt;<i> 2. if I want to JSON-parse ALL my requests should I a) use the
+</I>&gt;&gt;<i> onrequest/1 hook or b) do this on a per-request basis? Because I'd like
+</I>&gt;&gt;<i> to reply with a 400 ASAP but keep going if the JSON validates (I'm going
+</I>&gt;&gt;<i> to use JSON-schema for validating input); and, if possible, have the
+</I>&gt;&gt;<i> JSON-parsed body stored somewhere for future manipulation.
+</I>&gt;&gt;<i>
+</I>&gt;<i>
+</I>&gt;<i> It makes little sense to do it before the accept callback you define. Not
+</I>&gt;<i> only because you will duplicate content-type checks and whatnot, but also
+</I>&gt;<i> because you don't actually win anything from doing this. If you are using
+</I>&gt;<i> JSON, then JSON processing will take infinitely more resources than the
+</I>&gt;<i> REST code.
+</I>
+
+OK, I'll probably stick with a &quot;helper&quot; function that'll do this for me and
+reply in case there are validation errors.
+I only found the flow diagrams for the requests today after I had sent this
+message, and they helped a lot.
+
+
+&gt;<i> 3. I haven't seen examples that made use of the State (from the function
+</I>&gt;&gt;<i> returns). When should I use this instead of the Request metadata? I'd
+</I>&gt;&gt;<i> like to be able to set a generic error state for a request (either in
+</I>&gt;&gt;<i> meta ou State) and that have a &quot;standard&quot; error response be created at a
+</I>&gt;&gt;<i> later time (in a unique function, for example - e.g. onresponse/4).
+</I>&gt;&gt;<i>
+</I>&gt;<i>
+</I>&gt;<i> State is for the functions within the current module. Look at
+</I>&gt;<i> cowboy_static for an example.
+</I>
+
+State allows me to, well, keep state, for a request &quot;travelling&quot; through
+functions, right, and I can change it whenever I want just before returning
+from a function that is executed prior to another one (the only function
+for which this doesn't seem to make since is the last one cowboy calls
+before actually replying to the client)? At the same time, so does the
+request meta, from what I understood from the manual. So what is the
+difference between one and the other and when would you recommend one or
+the other.
+
+4. is there anything like a catch-all exception handler? I'd like to
+&gt;&gt;<i> catch exceptions that occur anywhere so I could log them and analyze
+</I>&gt;&gt;<i> them at a later moment.
+</I>&gt;&gt;<i>
+</I>&gt;<i>
+</I>&gt;<i> You can add your own error_logger handler, or use something like lager.
+</I>&gt;<i> All errors end up sending a message to error_logger.
+</I>
+
+I'll do this, thanks.
+
+
+&gt;<i> I'm probably abusing the onresponse/onrequest hooks already, so your
+</I>&gt;&gt;<i> answers should help me clarify this.
+</I>&gt;&gt;<i>
+</I>&gt;<i>
+</I>&gt;<i> Sounds like it!
+</I>&gt;<i>
+</I>&gt;<i> Thanks.
+</I>&gt;&gt;<i>
+</I>&gt;&gt;<i> - Paulo
+</I>&gt;&gt;<i>
+</I>&gt;&gt;<i>
+</I>&gt;&gt;<i> _______________________________________________
+</I>&gt;&gt;<i> Extend mailing list
+</I>&gt;&gt;<i> <A HREF="https://lists.ninenines.eu/listinfo/extend">Extend at lists.ninenines.eu</A>
+</I>&gt;&gt;<i> <A HREF="https://lists.ninenines.eu/listinfo/extend">https://lists.ninenines.eu/listinfo/extend</A>
+</I>&gt;&gt;<i>
+</I>&gt;&gt;<i>
+</I>&gt;<i> --
+</I>&gt;<i> Lo&#239;c Hoguin
+</I>&gt;<i> <A HREF="http://ninenines.eu">http://ninenines.eu</A>
+</I>&gt;<i>
+</I>
+Thanks.
+-------------- next part --------------
+An HTML attachment was scrubbed...
+URL: &lt;<A HREF="http://lists.ninenines.eu/archives/extend/attachments/20140520/32454f85/attachment.html">http://lists.ninenines.eu/archives/extend/attachments/20140520/32454f85/attachment.html</A>&gt;
+</PRE>
+
+<!--endarticle-->
+ <HR>
+ <P><UL>
+ <!--threads-->
+ <LI>Previous message: <A HREF="000386.html">[99s-extend] REST responses
+</A></li>
+ <LI>Next message: <A HREF="000389.html">[99s-extend] REST responses
+</A></li>
+ <LI> <B>Messages sorted by:</B>
+ <a href="date.html#388">[ date ]</a>
+ <a href="thread.html#388">[ thread ]</a>
+ <a href="subject.html#388">[ subject ]</a>
+ <a href="author.html#388">[ author ]</a>
+ </LI>
+ </UL>
+
+<hr>
+<a href="https://lists.ninenines.eu/listinfo/extend">More information about the Extend
+mailing list</a><br>
+</body></html>