summaryrefslogtreecommitdiffstats
path: root/dom/html/HTMLFormSubmission.h
diff options
context:
space:
mode:
Diffstat (limited to 'dom/html/HTMLFormSubmission.h')
-rw-r--r--dom/html/HTMLFormSubmission.h251
1 files changed, 251 insertions, 0 deletions
diff --git a/dom/html/HTMLFormSubmission.h b/dom/html/HTMLFormSubmission.h
new file mode 100644
index 000000000..2a07143c7
--- /dev/null
+++ b/dom/html/HTMLFormSubmission.h
@@ -0,0 +1,251 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set ts=8 sts=2 et sw=2 tw=80: */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#ifndef mozilla_dom_HTMLFormSubmission_h
+#define mozilla_dom_HTMLFormSubmission_h
+
+#include "mozilla/Attributes.h"
+#include "nsCOMPtr.h"
+#include "nsIContent.h"
+#include "nsNCRFallbackEncoderWrapper.h"
+#include "nsString.h"
+
+class nsIURI;
+class nsIInputStream;
+class nsGenericHTMLElement;
+class nsIMultiplexInputStream;
+
+namespace mozilla {
+namespace dom {
+
+class Blob;
+class Directory;
+
+/**
+ * Class for form submissions; encompasses the function to call to submit as
+ * well as the form submission name/value pairs
+ */
+class HTMLFormSubmission
+{
+public:
+ /**
+ * Get a submission object based on attributes in the form (ENCTYPE and
+ * METHOD)
+ *
+ * @param aForm the form to get a submission object based on
+ * @param aOriginatingElement the originating element (can be null)
+ * @param aFormSubmission the form submission object (out param)
+ */
+ static nsresult
+ GetFromForm(nsGenericHTMLElement* aForm,
+ nsGenericHTMLElement* aOriginatingElement,
+ HTMLFormSubmission** aFormSubmission);
+
+ virtual ~HTMLFormSubmission()
+ {
+ MOZ_COUNT_DTOR(HTMLFormSubmission);
+ }
+
+ /**
+ * Submit a name/value pair
+ *
+ * @param aName the name of the parameter
+ * @param aValue the value of the parameter
+ */
+ virtual nsresult
+ AddNameValuePair(const nsAString& aName, const nsAString& aValue) = 0;
+
+ /**
+ * Submit a name/blob pair
+ *
+ * @param aName the name of the parameter
+ * @param aBlob the blob to submit. The file's name will be used if the Blob
+ * is actually a File, otherwise 'blob' string is used instead if the aBlob is
+ * not null.
+ */
+ virtual nsresult
+ AddNameBlobOrNullPair(const nsAString& aName, Blob* aBlob) = 0;
+
+ /**
+ * Submit a name/directory pair
+ *
+ * @param aName the name of the parameter
+ * @param aBlob the directory to submit.
+ */
+ virtual nsresult AddNameDirectoryPair(const nsAString& aName,
+ Directory* aDirectory) = 0;
+
+ /**
+ * Reports whether the instance supports AddIsindex().
+ *
+ * @return true if supported.
+ */
+ virtual bool SupportsIsindexSubmission()
+ {
+ return false;
+ }
+
+ /**
+ * Adds an isindex value to the submission.
+ *
+ * @param aValue the field value
+ */
+ virtual nsresult AddIsindex(const nsAString& aValue)
+ {
+ NS_NOTREACHED("AddIsindex called when not supported");
+ return NS_ERROR_UNEXPECTED;
+ }
+
+ /**
+ * Given a URI and the current submission, create the final URI and data
+ * stream that will be submitted. Subclasses *must* implement this.
+ *
+ * @param aURI the URI being submitted to [INOUT]
+ * @param aPostDataStream a data stream for POST data [OUT]
+ */
+ virtual nsresult
+ GetEncodedSubmission(nsIURI* aURI, nsIInputStream** aPostDataStream) = 0;
+
+ /**
+ * Get the charset that will be used for submission.
+ */
+ void GetCharset(nsACString& aCharset)
+ {
+ aCharset = mCharset;
+ }
+
+ nsIContent* GetOriginatingElement() const
+ {
+ return mOriginatingElement.get();
+ }
+
+protected:
+ /**
+ * Can only be constructed by subclasses.
+ *
+ * @param aCharset the charset of the form as a string
+ * @param aOriginatingElement the originating element (can be null)
+ */
+ HTMLFormSubmission(const nsACString& aCharset,
+ nsIContent* aOriginatingElement)
+ : mCharset(aCharset)
+ , mOriginatingElement(aOriginatingElement)
+ {
+ MOZ_COUNT_CTOR(HTMLFormSubmission);
+ }
+
+ // The name of the encoder charset
+ nsCString mCharset;
+
+ // Originating element.
+ nsCOMPtr<nsIContent> mOriginatingElement;
+};
+
+class EncodingFormSubmission : public HTMLFormSubmission
+{
+public:
+ EncodingFormSubmission(const nsACString& aCharset,
+ nsIContent* aOriginatingElement);
+
+ virtual ~EncodingFormSubmission();
+
+ /**
+ * Encode a Unicode string to bytes using the encoder (or just copy the input
+ * if there is no encoder).
+ * @param aStr the string to encode
+ * @param aResult the encoded string [OUT]
+ * @param aHeaderEncode If true, turns all linebreaks into spaces and escapes
+ * all quotes
+ * @throws an error if UnicodeToNewBytes fails
+ */
+ nsresult EncodeVal(const nsAString& aStr, nsCString& aResult,
+ bool aHeaderEncode);
+
+private:
+ // The encoder that will encode Unicode names and values
+ nsNCRFallbackEncoderWrapper mEncoder;
+};
+
+/**
+ * Handle multipart/form-data encoding, which does files as well as normal
+ * inputs. This always does POST.
+ */
+class FSMultipartFormData : public EncodingFormSubmission
+{
+public:
+ /**
+ * @param aCharset the charset of the form as a string
+ */
+ FSMultipartFormData(const nsACString& aCharset,
+ nsIContent* aOriginatingElement);
+ ~FSMultipartFormData();
+
+ virtual nsresult
+ AddNameValuePair(const nsAString& aName, const nsAString& aValue) override;
+
+ virtual nsresult
+ AddNameBlobOrNullPair(const nsAString& aName, Blob* aBlob) override;
+
+ virtual nsresult
+ AddNameDirectoryPair(const nsAString& aName, Directory* aDirectory) override;
+
+ virtual nsresult
+ GetEncodedSubmission(nsIURI* aURI, nsIInputStream** aPostDataStream) override;
+
+ void GetContentType(nsACString& aContentType)
+ {
+ aContentType =
+ NS_LITERAL_CSTRING("multipart/form-data; boundary=") + mBoundary;
+ }
+
+ nsIInputStream* GetSubmissionBody(uint64_t* aContentLength);
+
+protected:
+
+ /**
+ * Roll up the data we have so far and add it to the multiplexed data stream.
+ */
+ nsresult AddPostDataStream();
+
+private:
+ void AddDataChunk(const nsACString& aName,
+ const nsACString& aFilename,
+ const nsACString& aContentType,
+ nsIInputStream* aInputStream,
+ uint64_t aInputStreamSize);
+ /**
+ * The post data stream as it is so far. This is a collection of smaller
+ * chunks--string streams and file streams interleaved to make one big POST
+ * stream.
+ */
+ nsCOMPtr<nsIMultiplexInputStream> mPostDataStream;
+
+ /**
+ * The current string chunk. When a file is hit, the string chunk gets
+ * wrapped up into an input stream and put into mPostDataStream so that the
+ * file input stream can then be appended and everything is in the right
+ * order. Then the string chunk gets appended to again as we process more
+ * name/value pairs.
+ */
+ nsCString mPostDataChunk;
+
+ /**
+ * The boundary string to use after each "part" (the boundary that marks the
+ * end of a value). This is computed randomly and is different for each
+ * submission.
+ */
+ nsCString mBoundary;
+
+ /**
+ * The total length in bytes of the streams that make up mPostDataStream
+ */
+ uint64_t mTotalLength;
+};
+
+} // namespace dom
+} // namespace mozilla
+
+#endif /* mozilla_dom_HTMLFormSubmission_h */