11

注意/免责声明：经过几次搜索后，我看到的最接近这篇文章的是关于 SO（方法链接和完成问题）的帖子，这与我的问题相似，但并没有真正回答 - 但无论如何，我希望这不是一个重复的问题。

我在做什么：

我已经为一堆方法调用创建了一个流利的接口作为现有日志框架的外观 - 所以我的语法看起来有点像这样：

Logger.Debug().Message("Debug message!").WriteToLog();
Logger.Error().Message("An exception occured").Exception(ex).WriteToLog();

我将一个内部对象从一个方法调用传递给下一个对象，以便在进行最终调用时（WriteToLog 方法）；消息被写入某处的日志文件。

我觉得有点臭

为了验证（仅当应用程序以调试模式构建时），我在上下文类（只是一个属性包对象）上有一个属性，该属性从方法调用传递到返回的对象，直到链终止；它是一个布尔值，默认为 false。

此属性在上下文类析构函数中使用 Debug.Assert 进行评估，以确定是否调用结束链的最终方法，以便在开发过程中获取任何日志记录错误。（属性、设置属性的代码和析构函数本身都是在#if DEBUG 预处理器指令的上下文中创建的，所以如果它是内置的或者如果符号不存在，代码将不会编译。）

我知道在 c#2.0 及更高版本中使用析构函数是不好的，而且我可能无法访问属性，因为我相信无法保证最终确定顺序。这就是为什么它只在调试模式下发生，以及为什么我想摆脱它。

我试图建立一个断言的原因是因为它很容易忘记并最终编写像

Logger.Debug().Message("Debug message!");

这意味着什么都不会被记录，尽管粗略一看，它看起来应该是这样。

我的问题

我想知道的是——谁能想到另一种方法来验证最终方法是否总是被调用？这些消息只是在开发期间需要向开发人员强调方法链尚未完成 - 我不希望最终用户找到与登录最终产品相关的错误消息。

4

1 回答 1

11

首先，我会质疑在这种情况下是否需要流畅的界面，似乎您可以使用更简单的界面轻松完成：

Logger.Debug.Message("Test");

甚至只是：

Logger.Debug("Test");

但是，如果您真的需要/想要一个流畅的接口，另一种方法是让流畅的接口在方法的参数上工作，而不是在返回值上工作。

所以不要这样做：

Method1().Method2().Method3();

然后忘记了最后的电话：

Method1().Method2().Method3().Execute();

您将改为组织代码，可能像这样：

Method1(o => o.Method2().Method3());

为此，您将定义一个对象，您将在该对象上调用所有流畅的方法：

public class LoggerOptions
{
    public LoggerOptions Debug() { LoggerType = LoggerType.Debug; return this; }
    public LoggerOptions Error() { LoggerType = LoggerType.Error; return this; }
    public LoggerOptions Message(string message) { ...; return this; }

    public LoggerType Type { get; set; }
    ...
}

这里的每个方法调用都会修改 LoggerOptions 对象，然后返回相同的实例，以继续流畅的接口。

进而：

public static class Logger
{
    public static void Log(Func<LoggerOptions, LoggerOptions> options)
    {
        LoggerOptions opts = options(new LoggerOptions());
        // do the logging, using properties/values from opts to guide you
    }
}

然后你会这样称呼它：

Logger.Log(opts => opts.Debug().Message("Debug message"));

如果您在完成设置选项对象之前绝对需要调用一些终端方法，则可以创建不同的对象：

public class LoggerOptions
{
    public LoggerOptions Debug() { LoggerType = LoggerType.Debug; return this; }
    public LoggerOptions Error() { LoggerType = LoggerType.Error; return this; }
    public LoggerOptions Message(string message) { ...; return this; }

    public LoggerType Type { get; set; }
    ...

    public LoggerFinalOptions ToEventLog() { ...; return new LoggerFinalOptions(this); }
    public LoggerFinalOptions ToFile(string fileName) { ...; return new LoggerFinalOptions(this); }
}

进而：

public static class Logger
{
    public static void Log(Func<LoggerOptions, LoggerFinalOptions> options)
    {
        LoggerFinalOptions opts = options(new LoggerOptions());
        // do the logging, using properties/values from opts to guide you
    }
}

这将保证如果不通过调用返回显式最终选项对象的方法来结束方法链，则无法编译代码：

// will not compile
Logger.Log(opts => opts.Debug().Message("Test"));

// will compile
Logger.Log(opts => opts.Debug().Message("Test").ToFile("log.log"));
于 2013-03-12T22:09:48.367 回答