Issue #1258 - Part 1: Import mailnews, ldap, and mork from comm-esr52.9.1

This commit is contained in:
Matt A. Tobin 2019-11-03 00:17:46 -04:00 • committed by Roy Tam
commit e400f4130a
1564 changed files with 510348 additions and 0 deletions

View file

@ -0,0 +1,544 @@
/* 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/. */
var Cc = Components.classes;
var Ci = Components.interfaces;
var Cr = Components.results;
var Cu = Components.utils;
Cu.import("resource://gre/modules/XPCOMUtils.jsm");
Cu.import("resource:///modules/errUtils.js");
var Gloda = null;
var GlodaUtils = null;
var MultiSuffixTree = null;
var TagNoun = null;
var FreeTagNoun = null;
function ResultRowFullText(aItem, words, typeForStyle) {
this.item = aItem;
this.words = words;
this.typeForStyle = "gloda-fulltext-" + typeForStyle;
}
ResultRowFullText.prototype = {
multi: false,
fullText: true
};
function ResultRowSingle(aItem, aCriteriaType, aCriteria, aExplicitNounID) {
this.nounID = aExplicitNounID || aItem.NOUN_ID;
this.nounDef = Gloda._nounIDToDef[this.nounID];
this.criteriaType = aCriteriaType;
this.criteria = aCriteria;
this.item = aItem;
this.typeForStyle = "gloda-single-" + this.nounDef.name;
}
ResultRowSingle.prototype = {
multi: false,
fullText: false
};
function ResultRowMulti(aNounID, aCriteriaType, aCriteria, aQuery) {
this.nounID = aNounID;
this.nounDef = Gloda._nounIDToDef[aNounID];
this.criteriaType = aCriteriaType;
this.criteria = aCriteria;
this.collection = aQuery.getCollection(this);
this.collection.becomeExplicit();
this.renderer = null;
}
ResultRowMulti.prototype = {
multi: true,
typeForStyle: "gloda-multi",
fullText: false,
onItemsAdded: function(aItems) {
if (this.renderer) {
for (let [iItem, item] of aItems.entries()) {
this.renderer.renderItem(item);
}
}
},
onItemsModified: function(aItems) {
},
onItemsRemoved: function(aItems) {
},
onQueryCompleted: function() {
}
};
function nsAutoCompleteGlodaResult(aListener, aCompleter, aString) {
this.listener = aListener;
this.completer = aCompleter;
this.searchString = aString;
this._results = [];
this._pendingCount = 0;
this._problem = false;
// Track whether we have reported anything to the complete controller so
// that we know not to send notifications to it during calls to addRows
// prior to that point.
this._initiallyReported = false;
this.wrappedJSObject = this;
}
nsAutoCompleteGlodaResult.prototype = {
getObjectAt: function(aIndex) {
return this._results[aIndex] || null;
},
markPending: function ACGR_markPending(aCompleter) {
this._pendingCount++;
},
markCompleted: function ACGR_markCompleted(aCompleter) {
if (--this._pendingCount == 0 && this.active) {
this.listener.onSearchResult(this.completer, this);
}
},
announceYourself: function ACGR_announceYourself() {
this._initiallyReported = true;
this.listener.onSearchResult(this.completer, this);
},
addRows: function ACGR_addRows(aRows) {
if (!aRows.length)
return;
this._results.push.apply(this._results, aRows);
if (this._initiallyReported && this.active) {
this.listener.onSearchResult(this.completer, this);
}
},
// ==== nsIAutoCompleteResult
searchString: null,
get searchResult() {
if (this._problem)
return Ci.nsIAutoCompleteResult.RESULT_FAILURE;
if (this._results.length)
return (!this._pendingCount) ? Ci.nsIAutoCompleteResult.RESULT_SUCCESS
: Ci.nsIAutoCompleteResult.RESULT_SUCCESS_ONGOING;
else
return (!this._pendingCount) ? Ci.nsIAutoCompleteResult.RESULT_NOMATCH
: Ci.nsIAutoCompleteResult.RESULT_NOMATCH_ONGOING;
},
active: false,
defaultIndex: -1,
errorDescription: null,
get matchCount() {
return (this._results === null) ? 0 : this._results.length;
},
// this is the lower text, (shows the url in firefox)
// we try and show the contact's name here.
getValueAt: function(aIndex) {
let thing = this._results[aIndex];
return thing.name || thing.value || thing.subject || null;
},
getLabelAt: function(aIndex) {
return this.getValueAt(aIndex);
},
// rich uses this to be the "title". it is the upper text
// we try and show the identity here.
getCommentAt: function(aIndex) {
let thing = this._results[aIndex];
if (thing.value) // identity
return thing.contact.name;
else
return thing.name || thing.subject;
},
// rich uses this to be the "type"
getStyleAt: function(aIndex) {
let row = this._results[aIndex];
return row.typeForStyle;
},
// rich uses this to be the icon
getImageAt: function(aIndex) {
let thing = this._results[aIndex];
if (!thing.value)
return null;
return ""; // we don't want to use gravatars as is.
/*
let md5hash = GlodaUtils.md5HashString(thing.value);
let gravURL = "http://www.gravatar.com/avatar/" + md5hash +
"?d=identicon&s=32&r=g";
return gravURL;
*/
},
getFinalCompleteValueAt: function(aIndex) {
return this.getValueAt(aIndex);
},
removeValueAt: function() {},
_stop: function() {
}
};
var MAX_POPULAR_CONTACTS = 200;
/**
* Complete contacts/identities based on name/email. Instant phase is based on
* a suffix-tree built of popular contacts/identities. Delayed phase relies
* on a LIKE search of all known contacts.
*/
function ContactIdentityCompleter() {
// get all the contacts
let contactQuery = Gloda.newQuery(Gloda.NOUN_CONTACT);
contactQuery.orderBy("-popularity").limit(MAX_POPULAR_CONTACTS);
this.contactCollection = contactQuery.getCollection(this, null);
this.contactCollection.becomeExplicit();
}
ContactIdentityCompleter.prototype = {
_popularitySorter: function(a, b){ return b.popularity - a.popularity; },
complete: function ContactIdentityCompleter_complete(aResult, aString) {
if (aString.length < 3) {
// In CJK, first name or last name is sometime used as 1 character only.
// So we allow autocompleted search even if 1 character.
//
// [U+3041 - U+9FFF ... Full-width Katakana, Hiragana
// and CJK Ideograph
// [U+AC00 - U+D7FF ... Hangul
// [U+F900 - U+FFDC ... CJK compatibility ideograph
if (!aString.match(/[\u3041-\u9fff\uac00-\ud7ff\uf900-\uffdc]/))
return false;
}
let matches;
if (this.suffixTree) {
matches = this.suffixTree.findMatches(aString.toLowerCase());
}
else
matches = [];
// let's filter out duplicates due to identity/contact double-hits by
// establishing a map based on the contact id for these guys.
// let's also favor identities as we do it, because that gets us the
// most accurate gravat, potentially
let contactToThing = {};
for (let iMatch = 0; iMatch < matches.length; iMatch++) {
let thing = matches[iMatch];
if (thing.NOUN_ID == Gloda.NOUN_CONTACT && !(thing.id in contactToThing))
contactToThing[thing.id] = thing;
else if (thing.NOUN_ID == Gloda.NOUN_IDENTITY)
contactToThing[thing.contactID] = thing;
}
// and since we can now map from contacts down to identities, map contacts
// to the first identity for them that we find...
matches = Object.keys(contactToThing).map(id => contactToThing[id]).
map(val => val.NOUN_ID == Gloda.NOUN_IDENTITY ? val : val.identities[0]);
let rows = matches.
map(match => new ResultRowSingle(match, "text", aResult.searchString));
aResult.addRows(rows);
// - match against database contacts / identities
let pending = {contactToThing: contactToThing, pendingCount: 2};
let contactQuery = Gloda.newQuery(Gloda.NOUN_CONTACT);
contactQuery.nameLike(contactQuery.WILDCARD, aString,
contactQuery.WILDCARD);
pending.contactColl = contactQuery.getCollection(this, aResult);
pending.contactColl.becomeExplicit();
let identityQuery = Gloda.newQuery(Gloda.NOUN_IDENTITY);
identityQuery.kind("email").valueLike(identityQuery.WILDCARD, aString,
identityQuery.WILDCARD);
pending.identityColl = identityQuery.getCollection(this, aResult);
pending.identityColl.becomeExplicit();
aResult._contactCompleterPending = pending;
return true;
},
onItemsAdded: function(aItems, aCollection) {
},
onItemsModified: function(aItems, aCollection) {
},
onItemsRemoved: function(aItems, aCollection) {
},
onQueryCompleted: function(aCollection) {
// handle the initial setup case...
if (aCollection.data == null) {
// cheat and explicitly add our own contact...
if (Gloda.myContact &&
!(Gloda.myContact.id in this.contactCollection._idMap))
this.contactCollection._onItemsAdded([Gloda.myContact]);
// the set of identities owned by the contacts is automatically loaded as part
// of the contact loading...
// (but only if we actually have any contacts)
this.identityCollection =
this.contactCollection.subCollections[Gloda.NOUN_IDENTITY];
let contactNames = this.contactCollection.items.
map(c => c.name.replace(" ", "").toLowerCase() || "x");
// if we had no contacts, we will have no identity collection!
let identityMails;
if (this.identityCollection)
identityMails = this.identityCollection.items.
map(i => i.value.toLowerCase());
// The suffix tree takes two parallel lists; the first contains strings
// while the second contains objects that correspond to those strings.
// In the degenerate case where identityCollection does not exist, it will
// be undefined. Calling concat with an argument of undefined simply
// duplicates the list we called concat on, and is thus harmless. Our
// use of && on identityCollection allows its undefined value to be
// passed through to concat. identityMails will likewise be undefined.
this.suffixTree = new MultiSuffixTree(contactNames.concat(identityMails),
this.contactCollection.items.concat(this.identityCollection &&
this.identityCollection.items));
return;
}
// handle the completion case
let result = aCollection.data;
let pending = result._contactCompleterPending;
if (--pending.pendingCount == 0) {
let possibleDudes = [];
let contactToThing = pending.contactToThing;
let items;
// check identities first because they are better than contacts in terms
// of display
items = pending.identityColl.items;
for (let iIdentity = 0; iIdentity < items.length; iIdentity++){
let identity = items[iIdentity];
if (!(identity.contactID in contactToThing)) {
contactToThing[identity.contactID] = identity;
possibleDudes.push(identity);
// augment the identity with its contact's popularity
identity.popularity = identity.contact.popularity;
}
}
items = pending.contactColl.items;
for (let iContact = 0; iContact < items.length; iContact++) {
let contact = items[iContact];
if (!(contact.id in contactToThing)) {
contactToThing[contact.id] = contact;
possibleDudes.push(contact.identities[0]);
}
}
// sort in order of descending popularity
possibleDudes.sort(this._popularitySorter);
let rows = possibleDudes.
map(dude => new ResultRowSingle(dude, "text", result.searchString));
result.addRows(rows);
result.markCompleted(this);
// the collections no longer care about the result, make it clear.
delete pending.identityColl.data;
delete pending.contactColl.data;
// the result object no longer needs us or our data
delete result._contactCompleterPending;
}
}
};
/**
* Complete tags that are used on contacts.
*/
function ContactTagCompleter() {
FreeTagNoun.populateKnownFreeTags();
this._buildSuffixTree();
FreeTagNoun.addListener(this);
}
ContactTagCompleter.prototype = {
_buildSuffixTree: function() {
let tagNames = [], tags = [];
for (let [tagName, tag] in Iterator(FreeTagNoun.knownFreeTags)) {
tagNames.push(tagName.toLowerCase());
tags.push(tag);
}
this._suffixTree = new MultiSuffixTree(tagNames, tags);
this._suffixTreeDirty = false;
},
onFreeTagAdded: function(aTag) {
this._suffixTreeDirty = true;
},
complete: function ContactTagCompleter_complete(aResult, aString) {
// now is not the best time to do this; have onFreeTagAdded use a timer.
if (this._suffixTreeDirty)
this._buildSuffixTree();
if (aString.length < 2)
return false; // no async mechanism that will add new rows
let tags = this._suffixTree.findMatches(aString.toLowerCase());
let rows = [];
for (let tag of tags) {
let query = Gloda.newQuery(Gloda.NOUN_CONTACT);
query.freeTags(tag);
let resRow = new ResultRowMulti(Gloda.NOUN_CONTACT, "tag", tag.name,
query);
rows.push(resRow);
}
aResult.addRows(rows);
return false; // no async mechanism that will add new rows
}
};
/**
* Complete tags that are used on messages
*/
function MessageTagCompleter() {
this._buildSuffixTree();
}
MessageTagCompleter.prototype = {
_buildSuffixTree: function MessageTagCompleter__buildSufficeTree() {
let tagNames = [], tags = [];
let tagArray = TagNoun.getAllTags();
for (let iTag = 0; iTag < tagArray.length; iTag++) {
let tag = tagArray[iTag];
tagNames.push(tag.tag.toLowerCase());
tags.push(tag);
}
this._suffixTree = new MultiSuffixTree(tagNames, tags);
this._suffixTreeDirty = false;
},
complete: function MessageTagCompleter_complete(aResult, aString) {
if (aString.length < 2)
return false;
let tags = this._suffixTree.findMatches(aString.toLowerCase());
let rows = [];
for (let tag of tags) {
let resRow = new ResultRowSingle(tag, "tag", tag.tag, TagNoun.id);
rows.push(resRow);
}
aResult.addRows(rows);
return false; // no async mechanism that will add new rows
}
};
/**
* Complete with helpful hints about full-text search
*/
function FullTextCompleter() {
}
FullTextCompleter.prototype = {
complete: function FullTextCompleter_complete(aResult, aSearchString) {
if (aSearchString.length < 4)
return false;
// We use code very similar to that in msg_search.js, except that we
// need to detect when we found phrases, as well as strip commas.
aSearchString = aSearchString.trim();
let terms = [];
let phraseFound = false;
while (aSearchString) {
let term = "";
if (aSearchString.startsWith('"')) {
let endIndex = aSearchString.indexOf(aSearchString[0], 1);
// eat the quote if it has no friend
if (endIndex == -1) {
aSearchString = aSearchString.substring(1);
continue;
}
phraseFound = true;
term = aSearchString.substring(1, endIndex).trim();
if (term)
terms.push(term);
aSearchString = aSearchString.substring(endIndex + 1);
continue;
}
let spaceIndex = aSearchString.indexOf(" ");
if (spaceIndex == -1) {
terms.push(aSearchString.replace(/,/g, ""));
break;
}
term = aSearchString.substring(0, spaceIndex).replace(/,/g, "");
if (term)
terms.push(term);
aSearchString = aSearchString.substring(spaceIndex+1);
}
if (terms.length == 1 && !phraseFound)
aResult.addRows([new ResultRowFullText(aSearchString, terms, "single")]);
else
aResult.addRows([new ResultRowFullText(aSearchString, terms, "all")]);
return false; // no async mechanism that will add new rows
}
};
var LOG;
function nsAutoCompleteGloda() {
this.wrappedJSObject = this;
try {
// set up our awesome globals!
if (Gloda === null) {
let loadNS = {};
Cu.import("resource:///modules/gloda/public.js", loadNS);
Gloda = loadNS.Gloda;
Cu.import("resource:///modules/gloda/utils.js", loadNS);
GlodaUtils = loadNS.GlodaUtils;
Cu.import("resource:///modules/gloda/suffixtree.js", loadNS);
MultiSuffixTree = loadNS.MultiSuffixTree;
Cu.import("resource:///modules/gloda/noun_tag.js", loadNS);
TagNoun = loadNS.TagNoun;
Cu.import("resource:///modules/gloda/noun_freetag.js", loadNS);
FreeTagNoun = loadNS.FreeTagNoun;
Cu.import("resource:///modules/gloda/log4moz.js", loadNS);
LOG = loadNS["Log4Moz"].repository.getLogger("gloda.autocomp");
}
this.completers = [];
this.curResult = null;
this.completers.push(new FullTextCompleter()); // not async.
this.completers.push(new ContactIdentityCompleter()); // potentially async.
this.completers.push(new ContactTagCompleter()); // not async.
this.completers.push(new MessageTagCompleter()); // not async.
} catch (e) {
logException(e);
}
}
nsAutoCompleteGloda.prototype = {
classID: Components.ID("{3bbe4d77-3f70-4252-9500-bc00c26f476d}"),
QueryInterface: XPCOMUtils.generateQI([
Components.interfaces.nsIAutoCompleteSearch]),
startSearch: function(aString, aParam, aResult, aListener) {
try {
let result = new nsAutoCompleteGlodaResult(aListener, this, aString);
// save this for hacky access to the search. I somewhat suspect we simply
// should not be using the formal autocomplete mechanism at all.
// Used in glodacomplete.xml.
this.curResult = result;
// Guard against late async results being sent.
this.curResult.active = true;
if (aParam == "global") {
for (let completer of this.completers) {
// they will return true if they have something pending.
if (completer.complete(result, aString))
result.markPending(completer);
}
//} else {
// It'd be nice to do autocomplete in the quicksearch modes based
// on the specific values for that mode in the current view.
// But we don't do that yet.
}
result.announceYourself();
} catch (e) {
logException(e);
}
},
stopSearch: function() {
this.curResult.active = false;
}
};
var components = [nsAutoCompleteGloda];
var NSGetFactory = XPCOMUtils.generateNSGetFactory(components);

View file

@ -0,0 +1,5 @@
component {3bbe4d77-3f70-4252-9500-bc00c26f476d} glautocomp.js
contract @mozilla.org/autocomplete/search;1?name=gloda {3bbe4d77-3f70-4252-9500-bc00c26f476d}
component {8cddbbbc-7ced-46b0-a936-8cddd1928c24} jsmimeemitter.js
contract @mozilla.org/gloda/jsmimeemitter;1 {8cddbbbc-7ced-46b0-a936-8cddd1928c24}
category mime-emitter @mozilla.org/messenger/mimeemitter;1?type=application/x-js-mime-message @mozilla.org/gloda/jsmimeemitter;1

View file

@ -0,0 +1,493 @@
/* 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/. */
var Cc = Components.classes;
var Ci = Components.interfaces;
var Cr = Components.results;
var Cu = Components.utils;
Cu.import("resource://gre/modules/XPCOMUtils.jsm");
var kStateUnknown = 0;
var kStateInHeaders = 1;
var kStateInBody = 2;
var kStateInAttachment = 3;
/**
* When the saneBodySize flag is active, limit body parts to at most this many
* bytes. See |MsgHdrToMimeMessage| for more information on the flag.
*
* The choice of 20k was made on the very scientific basis of running a query
* against my indexed e-mail and finding the point where these things taper
* off. I chose 20 because things had tapered off pretty firmly by 16, so
* 20 gave it some space and it was also the end of a mini-plateau.
*/
var MAX_SANE_BODY_PART_SIZE = 20 * 1024;
/**
* Custom nsIMimeEmitter to build a sub-optimal javascript representation of a
* MIME message. The intent is that a better mechanism than is evolved to
* provide a javascript-accessible representation of the message.
*
* Processing occurs in two passes. During the first pass, libmime is parsing
* the stream it is receiving, and generating header and body events for all
* MimeMessage instances it encounters. This provides us with the knowledge
* of each nested message in addition to the top level message, their headers
* and sort-of their bodies. The sort-of is that we may get more than
* would normally be displayed in cases involving multipart/alternatives.
* We have augmented libmime to have a notify_nested_options parameter which
* is enabled when we are the consumer. This option causes MimeMultipart to
* always emit a content-type header (via addHeaderField), defaulting to
* text/plain when an explicit value is not present. Additionally,
* addHeaderField is called with a custom "x-jsemitter-part-path" header with
* the value being the part path (ex: 1.2.2). Having the part path greatly
* simplifies our life for building the part hierarchy.
* During the second pass, the libmime object model is traversed, generating
* attachment notifications for all leaf nodes. From our perspective, this
* means file attachments and embedded messages (message/rfc822). We use this
* pass to create the attachment objects proper, which we then substitute into
* the part tree we have already built.
*/
function MimeMessageEmitter() {
this._mimeMsg = {};
Cu.import("resource:///modules/gloda/mimemsg.js", this._mimeMsg);
this._utils = {};
Cu.import("resource:///modules/gloda/utils.js", this._utils);
this._url = null;
this._partRE = this._utils.GlodaUtils.PART_RE;
this._outputListener = null;
this._curPart = null;
this._curAttachment = null;
this._partMap = {};
this._bogusPartTranslation = {};
this._state = kStateUnknown;
this._writeBody = false;
}
var deathToNewlines = /\n/g;
MimeMessageEmitter.prototype = {
classID: Components.ID("{8cddbbbc-7ced-46b0-a936-8cddd1928c24}"),
QueryInterface: XPCOMUtils.generateQI([Ci.nsIMimeEmitter]),
initialize: function mime_emitter_initialize(aUrl, aChannel, aFormat) {
this._url = aUrl;
this._curPart = new this._mimeMsg.MimeMessage();
// the partName is intentionally ""! not a place-holder!
this._curPart.partName = "";
this._curAttachment = "";
this._partMap[""] = this._curPart;
// pull options across...
let options = this._mimeMsg.MsgHdrToMimeMessage.OPTION_TUNNEL;
this._saneBodySize = (options && ("saneBodySize" in options)) ?
options.saneBodySize : false;
this._mimeMsg.MsgHdrToMimeMessage.RESULT_RENDEVOUZ[aUrl.spec] =
this._curPart;
},
complete: function mime_emitter_complete() {
this._url = null;
this._outputListener = null;
this._curPart = null;
this._curAttachment = null;
this._partMap = null;
this._bogusPartTranslation = null;
},
setPipe: function mime_emitter_setPipe(aInputStream, aOutputStream) {
// we do not care about these
},
set outputListener(aListener) {
this._outputListener = aListener;
},
get outputListener() {
return this._outputListener;
},
_stripParams: function mime_emitter__stripParams(aValue) {
let indexSemi = aValue.indexOf(";");
if (indexSemi >= 0)
aValue = aValue.substring(0, indexSemi);
return aValue;
},
_beginPayload: function mime_emitter__beginPayload(aContentType) {
let contentTypeNoParams = this._stripParams(aContentType).toLowerCase();
if (contentTypeNoParams == "text/plain" ||
contentTypeNoParams == "text/html" ||
contentTypeNoParams == "text/enriched") {
this._curPart = new this._mimeMsg.MimeBody(contentTypeNoParams);
this._writeBody = true;
}
else if (contentTypeNoParams == "message/rfc822") {
// startHeader will take care of this
this._curPart = new this._mimeMsg.MimeMessage();
// do not fall through into the content-type setting case; this
// content-type needs to get clobbered by the actual content-type of
// the enclosed message.
this._writeBody = false;
return;
}
// this is going to fall-down with TNEF encapsulation and such, we really
// need to just be consuming the object model.
else if (contentTypeNoParams.startsWith("multipart/")) {
this._curPart = new this._mimeMsg.MimeContainer(contentTypeNoParams);
this._writeBody = false;
}
else {
this._curPart = new this._mimeMsg.MimeUnknown(contentTypeNoParams);
this._writeBody = false;
}
// put the full content-type in the headers and normalize out any newlines
this._curPart.headers["content-type"] =
[aContentType.replace(deathToNewlines, "")];
},
// ----- Header Routines
/**
* StartHeader provides the base case for our processing. It is the first
* notification we receive when processing begins on the outer rfc822
* message. We do not receive an x-jsemitter-part-path notification for the
* message, but the aIsRootMailHeader tells us everything we need to know.
* (Or it would if we hadn't already set everything up in initialize.)
*
* When dealing with nested RFC822 messages, we will receive the
* addHeaderFields for the content-type and the x-jsemitter-part-path
* prior to the startHeader call. This is because the MIME multipart
* container that holds the message is the one generating the notification.
* For that reason, we do not process them here, but instead in
* addHeaderField and _beginPayload.
*
* We do need to track our state for addHeaderField's benefit though.
*/
startHeader: function mime_emitter_startHeader(aIsRootMailHeader,
aIsHeaderOnly, aMsgID, aOutputCharset) {
this._state = kStateInHeaders;
},
/**
* Receives a header field name and value for the current MIME part, which
* can be an rfc822/message or one of its sub-parts.
*
* The emitter architecture treats rfc822/messages as special because it was
* architected around presentation. In that case, the organizing concept
* is the single top-level rfc822/message. (It did not 'look into' nested
* messages in most cases.)
* As a result the interface is biased towards being 'in the headers' or
* 'in the body', corresponding to calls to startHeader and startBody,
* respectively.
* This information is interesting to us because the message itself is an
* odd pseudo-mime-part. Because it has only one child, its headers are,
* in a way, its payload, but they also serve as the description of its
* MIME child part. This introduces a complication in that we see the
* content-type for the message's "body" part before we actually see any
* of the headers. To deal with this, we punt on the construction of the
* body part to the call to startBody() and predicate our logic on the
* _state field.
*/
addHeaderField: function mime_emitter_addHeaderField(aField, aValue) {
if (this._state == kStateInBody) {
aField = aField.toLowerCase();
if (aField == "content-type")
this._beginPayload(aValue, true);
else if (aField == "x-jsemitter-part-path") {
// This is either naming the current part, or referring to an already
// existing part (in the case of multipart/related on its second pass).
// As such, check if the name already exists in our part map.
let partName = this._stripParams(aValue);
// if it does, then make the already-existing part at that path current
if (partName in this._partMap) {
this._curPart = this._partMap[partName];
this._writeBody = "body" in this._curPart;
}
// otherwise, name the part we are holding onto and place it.
else {
this._curPart.partName = partName;
this._placePart(this._curPart);
}
}
else if (aField == "x-jsemitter-encrypted" && aValue == "1") {
this._curPart.isEncrypted = true;
}
// There is no other field to be emitted in the body case other than the
// ones we just handled. (They were explicitly added for the js
// emitter.)
}
else if (this._state == kStateInHeaders) {
let lowerField = aField.toLowerCase();
if (lowerField in this._curPart.headers)
this._curPart.headers[lowerField].push(aValue);
else
this._curPart.headers[lowerField] = [aValue];
}
},
addAllHeaders: function mime_emitter_addAllHeaders(aAllHeaders, aHeaderSize) {
// This is called by the parsing code after the calls to AddHeaderField (or
// AddAttachmentField if the part is an attachment), and seems to serve
// a specialized, quasi-redundant purpose. (nsMimeBaseEmitter creates a
// nsIMimeHeaders instance and hands it to the nsIMsgMailNewsUrl.)
// nop
},
writeHTMLHeaders: function mime_emitter_writeHTMLHeaders(aName) {
// It doesn't look like this should even be part of the interface; I think
// only the nsMimeHtmlDisplayEmitter::EndHeader call calls this signature.
// nop
},
endHeader: function mime_emitter_endHeader(aName) {
},
updateCharacterSet: function mime_emitter_updateCharacterSet(aCharset) {
// we do not need to worry about this. it turns out this notification is
// exclusively for the benefit of the UI. libmime, believe it or not,
// is actually doing the right thing under the hood and handles all the
// encoding issues for us.
// so, get ready for the only time you will ever hear this:
// three cheers for libmime!
},
/**
* Place a part in its proper location; requires the parent to be present.
* However, we no longer require in-order addition of children. (This is
* currently a hedge against extension code doing wacky things. Our
* motivating use-case is multipart/related which actually does generate
* everything in order on its first pass, but has a wacky second pass. It
* does not actually trigger the out-of-order code because we have
* augmented the libmime code to generate its x-jsemitter-part-path info
* a second time, in which case we reuse the part we already created.)
*
* @param aPart Part to place.
*/
_placePart: function(aPart) {
let partName = aPart.partName;
this._partMap[partName] = aPart;
let [storagePartName, parentName, parentPart] = this._findOrCreateParent(partName);
let lastDotIndex = storagePartName.lastIndexOf(".");
if (parentPart !== undefined) {
let indexInParent = parseInt(storagePartName.substring(lastDotIndex+1)) - 1;
// handle out-of-order notification...
if (indexInParent < parentPart.parts.length)
parentPart.parts[indexInParent] = aPart;
else {
while (indexInParent > parentPart.parts.length)
parentPart.parts.push(null);
parentPart.parts.push(aPart);
}
}
},
/**
* In case the MIME structure is wrong, (i.e. we have no parent to add the
* current part to), this function recursively makes sure we create the
* missing bits in the hierarchy.
* What happens in the case of encrypted emails (mimecryp.cpp):
* 1. is the message
* 1.1 doesn't exist
* 1.1.1 is the multipart/alternative that holds the text/plain and text/html
* 1.1.1.1 is text/plain
* 1.1.1.2 is text/html
* This function fills the missing bits.
*/
_findOrCreateParent: function (aPartName) {
let partName = aPartName + "";
let parentName = partName.substring(0, partName.lastIndexOf("."));
let parentPart;
if (parentName in this._partMap) {
parentPart = this._partMap[parentName]
let lastDotIndex = partName.lastIndexOf(".");
let indexInParent = parseInt(partName.substring(lastDotIndex+1)) - 1;
if ("parts" in parentPart && indexInParent == parentPart.parts.length - 1)
return [partName, parentName, parentPart];
else
return this._findAnotherContainer(aPartName);
} else {
// Find the grandparent
let [, grandParentName, grandParentPart] = this._findOrCreateParent(parentName);
// Create the missing part.
let parentPart = new this._mimeMsg.MimeContainer("multipart/fake-container");
// Add it to the grandparent, remember we added it in the hierarchy.
grandParentPart.parts.push(parentPart);
this._partMap[parentName] = parentPart;
return [partName, parentName, parentPart];
}
},
/**
* In the case of UUEncoded attachments, libmime tells us about the attachment
* as a child of a MimeBody. This obviously doesn't make us happy, so in case
* libmime wants us to attach an attachment to something that's not a
* container, we walk up the mime tree to find a suitable container to hold
* the attachment.
* The results are cached so that they're consistent accross calls — this
* ensures the call to _replacePart works fine.
*/
_findAnotherContainer: function(aPartName) {
if (aPartName in this._bogusPartTranslation)
return this._bogusPartTranslation[aPartName];
let parentName = aPartName + "";
let parentPart;
while (!(parentPart && "parts" in parentPart) && parentName.length) {
parentName = parentName.substring(0, parentName.lastIndexOf("."));
parentPart = this._partMap[parentName];
}
let childIndex = parentPart.parts.length;
let fallbackPartName = (parentName ? parentName +"." : "")+(childIndex+1);
return (this._bogusPartTranslation[aPartName] = [fallbackPartName, parentName, parentPart]);
},
/**
* In the case of attachments, we need to replace an existing part with a
* more representative part...
*
* @param aPart Part to place.
*/
_replacePart: function(aPart) {
// _partMap always maps the libmime names to parts
let partName = aPart.partName;
this._partMap[partName] = aPart;
let [storagePartName, parentName, parentPart] = this._findOrCreateParent(partName);
let childNamePart = storagePartName.substring(storagePartName.lastIndexOf(".")+1);
let childIndex = parseInt(childNamePart) - 1;
// The attachment has been encapsulated properly in a MIME part (most of
// the cases). This does not hold for UUencoded-parts for instance (see
// test_mime_attachments_size.js for instance).
if (childIndex < parentPart.parts.length) {
let oldPart = parentPart.parts[childIndex];
parentPart.parts[childIndex] = aPart;
// copy over information from the original part
aPart.parts = oldPart.parts;
aPart.headers = oldPart.headers;
aPart.isEncrypted = oldPart.isEncrypted;
} else {
parentPart.parts[childIndex] = aPart;
}
},
// ----- Attachment Routines
// The attachment processing happens after the initial streaming phase (during
// which time we receive the messages, both bodies and headers). Our caller
// traverses the libmime child object hierarchy, emitting an attachment for
// each leaf object or sub-message.
startAttachment: function mime_emitter_startAttachment(aName, aContentType,
aUrl, aIsExternalAttachment) {
this._state = kStateInAttachment;
// we need to strip our magic flags from the URL; this regexp matches all
// the specific flags that the jsmimeemitter understands (we abuse the URL
// parameters to pass information all the way to here)
aUrl = aUrl.replace(/((header=filter|emitter=js|fetchCompleteMessage=(true|false)|examineEncryptedParts=(true|false)))&?/g, "");
// the url should contain a part= piece that tells us the part name, which
// we then use to figure out where to place that part if it's a real
// attachment.
let partMatch, partName;
if (aUrl.startsWith("http") || aUrl.startsWith("file")) {
// if we have a remote url, unlike non external mail part urls, it may also
// contain query strings starting with ?; PART_RE does not handle this.
partMatch = aUrl.match(/[?&]part=[^&]+$/);
partMatch = partMatch && partMatch[0];
partName = partMatch && partMatch.split("part=")[1];
}
else {
partMatch = this._partRE.exec(aUrl);
partName = partMatch && partMatch[1];
}
this._curAttachment = partName;
if (aContentType == "message/rfc822") {
// we want to offer extension authors a way to see attachments as the
// message readers sees them, which means attaching an extra url property
// to the part that was already created before
if (partName) {
// we disguise this MimeMessage into something that can be used as a
// MimeAttachment so that it is transparent for the user code
this._partMap[partName].url = aUrl;
this._partMap[partName].isExternal = aIsExternalAttachment;
this._partMap[partName].name = aName;
this._partMap[partName].isRealAttachment = true;
}
}
else if (partName) {
let part = new this._mimeMsg.MimeMessageAttachment(partName,
aName, aContentType, aUrl, aIsExternalAttachment);
// replace the existing part with the attachment...
this._replacePart(part);
}
},
addAttachmentField: function mime_emitter_addAttachmentField(aField, aValue) {
// What gets passed in here is X-Mozilla-PartURL with a value that
// is completely identical to aUrl from the call to startAttachment.
// (it's the same variable they use in each case). As such, there is
// no reason to handle that here.
// However, we also pass information about the size of the attachment, and
// that we want to handle
if (aField == "X-Mozilla-PartSize" && (this._curAttachment in this._partMap))
this._partMap[this._curAttachment].size = parseInt(aValue);
},
endAttachment: function mime_emitter_endAttachment() {
// don't need to do anything here, since we don't care about the headers.
},
endAllAttachments: function mime_emitter_endAllAttachments() {
// nop
},
// ----- Body Routines
/**
* We don't get an x-jsemitter-part-path for the message body, and we ignored
* our body part's content-type in addHeaderField, so this serves as our
* notice to set up the part (giving it a name).
*/
startBody: function mime_emitter_startBody(aIsBodyOnly, aMsgID, aOutCharset) {
this._state = kStateInBody;
let subPartName = (this._curPart.partName == "") ?
"1" :
this._curPart.partName + ".1";
this._beginPayload(this._curPart.get("content-type", "text/plain"));
this._curPart.partName = subPartName;
this._placePart(this._curPart);
},
/**
* Write to the body. When saneBodySize is active, we stop adding if we are
* already at the limit for this body part.
*/
writeBody: function mime_emitter_writeBody(aBuf, aSize, aOutAmountWritten) {
if (this._writeBody &&
(!this._saneBodySize ||
this._curPart.size < MAX_SANE_BODY_PART_SIZE))
this._curPart.appendBody(aBuf);
},
endBody: function mime_emitter_endBody() {
},
// ----- Generic Write (confusing)
// (binary data writing...)
write: function mime_emitter_write(aBuf, aSize, aOutAmountWritten) {
// we don't actually ever get called because we don't have the attachment
// binary payloads pass through us, but we do the following just in case
// we did get called (otherwise the caller gets mad and throws exceptions).
aOutAmountWritten.value = aSize;
},
// (string writing)
utilityWrite: function mime_emitter_utilityWrite(aBuf) {
this.write(aBuf, aBuf.length, {});
},
};
var components = [MimeMessageEmitter];
var NSGetFactory = XPCOMUtils.generateNSGetFactory(components);

View file

@ -0,0 +1,11 @@
# vim: set filetype=python:
# 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/.
EXTRA_COMPONENTS += [
'glautocomp.js',
'gloda.manifest',
'jsmimeemitter.js',
]