UnrealEngineUWP/Engine/Source/Developer/MessageLog/Private/Model/MessageLogListingModel.h

// Copyright 1998-2014 Epic Games, Inc. All Rights Reserved.

#pragma once

#include "TokenizedMessage.h"

/** Define the container type for all the messages */
typedef TArray< TSharedRef<FTokenizedMessage> > MessageContainer;

/** This class represents a set of rich tokenized messages for a particular system */
class FMessageLogListingModel : public TSharedFromThis< FMessageLogListingModel >
{
protected:
	struct FPage
	{
		FPage( const FText& InTitle )
			: Title( InTitle )
		{
		}

		/** The title of this page */
		FText Title;

		/** The list of messages in this log listing */
		MessageContainer Messages;
	};

public:

	/**  
	 *	Factory method which creates a new FMessageLogListingModel object
	 *
	 *	@param	InLogName		The name of the log
	 */
	static TSharedRef< FMessageLogListingModel > Create( const FName& InLogName )
	{
		TSharedRef< FMessageLogListingModel > NewLogListing( new FMessageLogListingModel( InLogName ) );
		return NewLogListing;
	}

	/** Broadcasts whenever the message log listing changes */
	DECLARE_EVENT( FMessageLogListingModel, FChangedEvent )
	FChangedEvent& OnChanged() { return ChangedEvent; }

	/** Retrieves the name identifier for this log listing */
	const FName& GetName() const { return LogName; }

	/** Returns the message at the specified index */
	const TSharedPtr<FTokenizedMessage> GetMessageAtIndex( const uint32 PageIndex, const int32 MessageIndex ) const;

	/** Tries to find the first message that matches the message data */
	const TSharedPtr<FTokenizedMessage> GetMessageFromData( const FTokenizedMiscData& MessageData ) const;

	/** Gets all messages as a string */
	FText GetAllMessagesAsText(const uint32 PageIndex) const;

	/** Obtains a const iterator to the message data structure */
	MessageContainer::TConstIterator GetMessageIterator(uint32 PageIndex) const;

	/** Replaces the message at the given index */
	int32 ReplaceMessage( const TSharedRef< FTokenizedMessage >& NewMessage, const uint32 PageIndex, const int32 MessageIndex );

	/** Appends a message */
	void AddMessage( const TSharedRef< FTokenizedMessage >& NewMessage );

	/** Appends multiple messages */
	void AddMessages( const TArray< TSharedRef< FTokenizedMessage > >& NewMessages );

	/** Clears all messages */
	void ClearMessages();

	/**
	 * Add a new page. Old pages are only kept around if they contain messages, so if the current
	 * page is empty, this call does nothing.
	 * @param	InTitle		The title that will be displayed for this page.
	 * @param	InMaxPages	The maximum number of pages we keep around. If the count is exceeded, 
	 *						we discard the oldest page.
	 */
	void NewPage( const FText& InTitle, uint32 InMaxPages );

	/** Get the number of pages contained in this log */
	uint32 NumPages() const;

	/** Get the number of messages on the passed-in page */
	uint32 NumMessages( uint32 PageIndex ) const;

	/**
	 * Get the title of the page at the specified index
	 * @param	PageIndex	The index of the page
	 */
	const FText& GetPageTitle( const uint32 PageIndex ) const;

	/** Helper function for RemoveDuplicates(), exposed so the ViewModel can use it too */
	static bool AreMessagesEqual(const TSharedRef< FTokenizedMessage >& Message0, const TSharedRef< FTokenizedMessage >& Message1);

	/** Remove any messages that are duplicates of one another - O(n^2) */
	void RemoveDuplicates(uint32 PageIndex);

protected:

	/** Will broadcast to all registered observers informing them of a change */
	virtual void Notify() { ChangedEvent.Broadcast(); }

	/** Access the current page (we only add messages to this page */
	FPage& CurrentPage() const;

	/** Get a page by index - uses cache to speed up linked list access */
	FPage* PageAtIndex(const uint32 PageIndex) const;

	/** Create a new page if we have one pending */
	void CreateNewPageIfRequired();

private:
	/**
	 *	FMessageLogListingModel Constructor
	 *
	 *	@param	InLogName		The name of the log
	 */
	FMessageLogListingModel( const FName& InLogName )
		: LogName( InLogName )
	{
		check( LogName != NAME_None );

		// create default page
		Pages.AddTail(FPage(FText::FromName(LogName)));
		CachedPage = &Pages.GetTail()->GetValue();
		CachedPageIndex = 0;
	}

	/** Helper function for AddMessage and AddMessages */
	void AddMessageInternal( const TSharedRef<FTokenizedMessage>& NewMessage );
	
private:
	/** The name of a pending page */
	FText PendingPageName;

	/** The cap on the number of pages we have */
	uint32 MaxPages;

	/** The list of pages in this log listing */
	TDoubleLinkedList<FPage> Pages;

	/** Name of the listing, for identification */
	FName LogName;

	/** Delegate to call when data is changed */
	FChangedEvent ChangedEvent;

	/** Cached page index */
	mutable uint32 CachedPageIndex;

	/** Cached page */
	mutable FPage* CachedPage;
};