mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-12-13 10:25:01 +00:00
363 lines
13 KiB
C++
363 lines
13 KiB
C++
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
|
|
*
|
|
* The contents of this file are subject to the Netscape Public License
|
|
* Version 1.0 (the "NPL"); you may not use this file except in
|
|
* compliance with the NPL. You may obtain a copy of the NPL at
|
|
* http://www.mozilla.org/NPL/
|
|
*
|
|
* Software distributed under the NPL is distributed on an "AS IS" basis,
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the NPL
|
|
* for the specific language governing rights and limitations under the
|
|
* NPL.
|
|
*
|
|
* The Initial Developer of this code under the NPL is Netscape
|
|
* Communications Corporation. Portions created by Netscape are
|
|
* Copyright (C) 1998 Netscape Communications Corporation. All Rights
|
|
* Reserved.
|
|
*/
|
|
|
|
#ifndef __msg_NewsHost__
|
|
#define __msg_NewsHost__ 1
|
|
|
|
#include "msghost.h"
|
|
#include "xp_hash.h"
|
|
#include "ptrarray.h"
|
|
|
|
class MSG_FolderInfo;
|
|
class MSG_FolderInfoNews;
|
|
class MSG_Master;
|
|
class msg_GroupRecord;
|
|
class MSG_FolderInfoCategoryContainer;
|
|
|
|
class MSG_NewsHost : public MSG_Host {
|
|
public:
|
|
MSG_NewsHost(MSG_Master* master, const char* name, XP_Bool secure,
|
|
int32 port);
|
|
virtual ~MSG_NewsHost();
|
|
|
|
virtual XP_Bool IsNews () { return TRUE; }
|
|
virtual MSG_NewsHost *GetNewsHost() { return this; }
|
|
|
|
void addNew(MSG_GroupName* group);
|
|
void ClearNew();
|
|
|
|
virtual void dump();
|
|
|
|
virtual int32 getPort();
|
|
virtual XP_Bool isSecure();
|
|
|
|
time_t getLastUpdate();
|
|
void setLastUpdate(time_t date);
|
|
|
|
// Return the name of this newshost.
|
|
const char* getStr();
|
|
|
|
// Returns the name of this newshost, possibly followed by ":<port>" if
|
|
// the port number for this newshost is not the default.
|
|
const char* getNameAndPort();
|
|
|
|
// Returns a fully descriptive name for this newshost, including the
|
|
// above ":<port>" and also possibly a trailing (and localized) " (secure)"
|
|
virtual const char* getFullUIName();
|
|
|
|
// Go load the newsrc for this host. Creates the subscribed hosts as
|
|
// children of the given MSG_FolderInfo.
|
|
int LoadNewsrc(MSG_FolderInfo* hostinfo);
|
|
|
|
// Get the MSG_FolderInfo which represents this host; the children
|
|
// of this MSG_FolderInfo are the groups in this host.
|
|
MSG_FolderInfo* GetHostInfo() {return m_hostinfo;}
|
|
|
|
// Write out the newsrc for this host right now. In general, either
|
|
// MarkDirty() or WriteIfDirty() should be called instead.
|
|
int WriteNewsrc();
|
|
|
|
// Write out the newsrc for this host right now, if anything has changed
|
|
// in it.
|
|
int WriteIfDirty();
|
|
|
|
// Note that something has changed, and we need to rewrite the newsrc file
|
|
// for this host at some point.
|
|
void MarkDirty();
|
|
|
|
const char* GetNewsrcFileName();
|
|
int SetNewsrcFileName(const char* name);
|
|
|
|
MSG_Master* GetMaster() {
|
|
return m_master;
|
|
}
|
|
|
|
MSG_FolderInfoNews* FindGroup(const char* name);
|
|
|
|
MSG_FolderInfoNews *AddGroup(const char *groupName);
|
|
void RemoveGroup(const char* groupName);
|
|
void RemoveGroup(MSG_FolderInfoNews*);
|
|
|
|
const char* GetDBDirName(); // Name of directory to store newsgroup
|
|
// databases in. This needs to have
|
|
// "/groupname" appended to it, and the
|
|
// whole thing can be passed to the XP_File
|
|
// stuff with a type of xpXoverCache.
|
|
|
|
// GetNumGroupsNeedingCounts() returns how many newsgroups we have
|
|
// that we don't have an accurate count of unread/total articles.
|
|
int32 GetNumGroupsNeedingCounts();
|
|
|
|
// GetFirstGroupNeedingCounts() returns the name of the first newsgroup
|
|
// that does not have an accurate count of unread/total articles. The
|
|
// string must be free'd by the caller using XP_FREE().
|
|
char* GetFirstGroupNeedingCounts();
|
|
|
|
|
|
// GetFirstGroupNeedingExtraInfo() returns the name of the first newsgroup
|
|
// that does not have extra info (xactive flags and prettyname). The
|
|
// string must be free'd by the caller using XP_FREE().
|
|
char* GetFirstGroupNeedingExtraInfo();
|
|
|
|
char** GetGroupList(); // Returns a list of newsgroups. The result
|
|
// must be free'd using XP_FREE(); the
|
|
// individual strings must not be free'd.
|
|
|
|
void SetWantNewTotals(XP_Bool value); // Sets this bit on every newsgroup
|
|
// in this host.
|
|
|
|
XP_Bool NeedsExtension (const char *ext);
|
|
|
|
void AddExtension (const char *ext);
|
|
XP_Bool QueryExtension (const char *ext);
|
|
|
|
void AddSearchableGroup (const char *group);
|
|
XP_Bool QuerySearchableGroup (const char *group);
|
|
const char *QuerySearchableGroupCharsets(const char *group);
|
|
|
|
void AddSearchableHeader (const char *header);
|
|
XP_Bool QuerySearchableHeader (const char *header);
|
|
|
|
void AddPropertyForGet (const char *property, const char *value);
|
|
const char *QueryPropertyForGet (const char *property);
|
|
|
|
|
|
void SetPostingAllowed (XP_Bool allowed) { m_postingAllowed = allowed; }
|
|
XP_Bool GetPostingAllowed() { return m_postingAllowed; }
|
|
|
|
void SetSupportsExtensions (XP_Bool isSupported)
|
|
{ m_supportsExtensions = isSupported; }
|
|
XP_Bool GetSupportsExtensions () { return m_supportsExtensions; }
|
|
|
|
XP_Bool GetPushAuth() { return m_pushAuth; }
|
|
void SetPushAuth(XP_Bool pushAuth);
|
|
|
|
// Returns the base part of the URL for this newshost, in the
|
|
// form "news://hostname:port" or "snews://hostname:port".
|
|
// Note that no trailing slash is appended, and that the
|
|
// ":port" part will be omitted if this host uses the default
|
|
// port.
|
|
const char* GetURLBase();
|
|
|
|
XP_Bool GetEverExpanded() {return m_everexpanded;}
|
|
void SetEverExpanded(XP_Bool value) {m_everexpanded = value;}
|
|
XP_Bool GetCheckedForNew() {return m_checkedForNew;}
|
|
void SetCheckedForNew(XP_Bool value) {m_checkedForNew = value;}
|
|
void SetGroupSucceeded(XP_Bool value) {m_groupSucceeded = value;}
|
|
// Completely obliterate this news host. Remove all traces of it from
|
|
// disk and memory.
|
|
int RemoveHost();
|
|
|
|
// Returns the pretty name for the given group. The resulting string
|
|
// must be free'd using delete[].
|
|
char* GetPrettyName(const char* groupname);
|
|
int SetPrettyName(const char* groupname, const char* prettyname);
|
|
|
|
|
|
time_t GetAddTime(const char* groupname);
|
|
|
|
// Returns a unique integer associated with this newsgroup. This is
|
|
// mostly used by Win16 to generate a 8.3 filename.
|
|
int32 GetUniqueID(const char* groupname);
|
|
|
|
XP_Bool IsCategory(const char* groupname);
|
|
XP_Bool IsCategoryContainer(const char* groupname);
|
|
int SetIsCategoryContainer(const char* groupname, XP_Bool value);
|
|
|
|
int SetGroupNeedsExtraInfo(const char *groupname, XP_Bool value);
|
|
// Finds the container newsgroup for this category (or NULL if this isn't
|
|
// a category). The resulting string must be free'd using delete[].
|
|
char* GetCategoryContainer(const char* groupname);
|
|
MSG_FolderInfoNews *GetCategoryContainerFolderInfo(const char *groupname);
|
|
|
|
// Get/Set whether this is a virtual newsgroup.
|
|
XP_Bool IsProfile(const char* groupname);
|
|
int SetIsProfile(const char* groupname, XP_Bool value);
|
|
|
|
// Get/Set whether this is a real group (as opposed to a container of
|
|
// other groups, like "mcom".)
|
|
XP_Bool IsGroup(const char* groupname);
|
|
int SetIsGroup(const char* groupname, XP_Bool value);
|
|
|
|
|
|
// Returns TRUE if it's OK to post HTML in this group (either because the
|
|
// bit is on for this group, or one of this group's ancestor's has marked
|
|
// all of its descendents as being OK for HTML.)
|
|
XP_Bool IsHTMLOk(const char* groupname);
|
|
|
|
// Get/Set if it's OK to post HTML in just this group.
|
|
XP_Bool IsHTMLOKGroup(const char* groupname);
|
|
int SetIsHTMLOKGroup(const char* groupname, XP_Bool value);
|
|
|
|
// Get/Set if it's OK to post HTML in this group and all of its subgroups.
|
|
XP_Bool IsHTMLOKTree(const char* groupname);
|
|
int SetIsHTMLOKTree(const char* groupname, XP_Bool value);
|
|
|
|
// Create the given group (if not already present). Returns 0 if the
|
|
// group is already present, 1 if we had to create it, negative on error.
|
|
// The given group will have the "isgroup" bit set on it (in other words,
|
|
// it is not to be just a container of other groups, like "mcom" is.)
|
|
int NoticeNewGroup(const char* groupname);
|
|
|
|
|
|
// Makes sure that we have records in memory for all known descendants
|
|
// of the given newsgroup.
|
|
int AssureAllDescendentsLoaded(msg_GroupRecord* group);
|
|
|
|
|
|
int SaveHostInfo();
|
|
|
|
// Suck the entire hostinfo file into memory. If force is TRUE, then throw
|
|
// away whatever we had in memory first.
|
|
int Inhale(XP_Bool force = FALSE);
|
|
|
|
// If we inhale'd, then write thing out to the file and free up the
|
|
// memory.
|
|
int Exhale();
|
|
|
|
// Inhale, but make believe the file is empty. In other words, set the
|
|
// inhaled bit, but empty out the memory.
|
|
int EmptyInhale();
|
|
|
|
msg_GroupRecord* GetGroupTree() {return m_groupTree;}
|
|
time_t GetFirstNewDate() {return m_firstnewdate;}
|
|
|
|
void GroupNotFound(const char *groupName, XP_Bool opening);
|
|
|
|
int ReorderGroup (MSG_FolderInfoNews *groupToMove, MSG_FolderInfoNews *groupToMoveBefore, int32 *newIdx);
|
|
|
|
protected:
|
|
void OpenGroupFile(const XP_FilePerm permissions = XP_FILE_UPDATE_BIN);
|
|
int32 RememberLine(char* line);
|
|
static int32 ProcessLine_s(char* line, uint32 line_size, void* closure);
|
|
int32 ProcessLine(char* line, uint32 line_size);
|
|
static void WriteTimer(void* closure);
|
|
int CreateFileHeader();
|
|
int ReadInitialPart();
|
|
msg_GroupRecord* FindGroupInBlock(msg_GroupRecord* parent,
|
|
const char* groupname,
|
|
int32* comp);
|
|
msg_GroupRecord* LoadSingleEntry(msg_GroupRecord* parent,
|
|
const char* groupname,
|
|
int32 min, int32 max);
|
|
static int32 InhaleLine(char* line, uint32 length, void* closure);
|
|
msg_GroupRecord* FindOrCreateGroup(const char* groupname,
|
|
int* statusOfMakingGroup = NULL);
|
|
|
|
MSG_FolderInfoNews *SwitchNewsToCategoryContainer(MSG_FolderInfoNews *newsInfo);
|
|
MSG_FolderInfoNews *SwitchCategoryContainerToNews(MSG_FolderInfoCategoryContainer *catContainerInfo);
|
|
|
|
char* m_hostname;
|
|
int32 m_port;
|
|
XP_Bool m_secure;
|
|
|
|
char* m_nameAndPort;
|
|
char* m_fullUIName;
|
|
|
|
MSG_FolderArray* m_groups; // List of MSG_FolderInfoNews* objects.
|
|
MSG_Master* m_master;
|
|
|
|
MSG_FolderInfo* m_hostinfo; // Object representing entire newshost in
|
|
// tree.
|
|
char* m_optionLines;
|
|
|
|
|
|
char* m_filename; /* The name of the newsrc file associated with
|
|
this host. This will be of the form:
|
|
|
|
"" meaning .newsrc or .snewsrc
|
|
HOST meaning .newsrc-HOST
|
|
HOST:PORT meaning .newsrc-HOST:PORT
|
|
|
|
Whether it begins with .newsrc or .snewsrc
|
|
depends on the secure_p slot (we pass one of
|
|
the types xpNewsRC or xpSNewsRC to xp_file.)
|
|
|
|
The reason this is not simply derived from
|
|
the host_name and port slots is that it's
|
|
not a 1:1 mapping; if the user has a file
|
|
called "newsrc", we will use that for the
|
|
default host (the "" name.) Likewise,
|
|
".newsrc-H" and ".newsrc-H:119" are
|
|
ambiguous.
|
|
*/
|
|
|
|
char* m_dbfilename;
|
|
XP_Bool m_dirty;
|
|
XP_Bool m_supportsExtensions;
|
|
void* m_writetimer;
|
|
char* m_urlbase;
|
|
XP_Bool m_everexpanded; // Whether the user ever opened up this
|
|
// newshost this session.
|
|
XP_Bool m_checkedForNew; // Whether we've checked for new newgroups
|
|
// in this newshost this session.
|
|
XP_Bool m_groupSucceeded; // Whether a group command has succeeded this
|
|
// session, protect against server bustage
|
|
// where it says no group exists.
|
|
|
|
XPPtrArray m_supportedExtensions;
|
|
XPPtrArray m_searchableGroups;
|
|
XPPtrArray m_searchableHeaders;
|
|
// ### mwelch Added to determine what charsets can be used
|
|
// for each table.
|
|
XP_HashTable m_searchableGroupCharsets;
|
|
|
|
XPPtrArray m_propertiesForGet;
|
|
XPPtrArray m_valuesForGet;
|
|
|
|
XP_Bool m_postingAllowed;
|
|
XP_Bool m_pushAuth; // TRUE if we should volunteer authentication without a
|
|
// challenge
|
|
|
|
time_t m_lastgroupdate;
|
|
time_t m_firstnewdate;
|
|
|
|
|
|
msg_GroupRecord* m_groupTree; // Tree of groups we're remembering.
|
|
XP_Bool m_inhaled; // Whether we inhaled the entire list of
|
|
// groups, or just some.
|
|
int m_groupTreeDirty; // Whether the group tree is dirty. If 0, then
|
|
// we don't need to write anything. If 1, then
|
|
// we can write things in place. If >1, then
|
|
// we need to rewrite the whole tree file.
|
|
char* m_hostinfofilename; // Filename of the hostinfo file.
|
|
|
|
static MSG_NewsHost* M_FileOwner; // In an effort to save file descriptors,
|
|
// only one newshost ever has its
|
|
// hostinfo file opened. This is the
|
|
// one.
|
|
|
|
XP_File m_groupFile; // File handle to the hostinfo file.
|
|
char* m_groupFilePermissions; // Permissions used to create the above
|
|
// file handle.
|
|
|
|
char* m_block; // A block of text read from the hostinfo file.
|
|
int32 m_blockSize; // How many bytes allocated in m_block.
|
|
int32 m_blockStart; // Where in the file we read the data that is
|
|
// currently sitting in m_block.
|
|
int32 m_fileStart; // Where in the file the actual newsgroup data
|
|
// starts.
|
|
int32 m_fileSize; // Total number of bytes in the hostinfo file.
|
|
int32 m_uniqueId; // Unique number assigned to each newsgroup.
|
|
|
|
};
|
|
|
|
|
|
|
|
#endif /* __msg_NewsHost__ */
|