注意/免责声明:经过几次搜索后,我在本帖中看到的最接近的内容是SO上的帖子(Method chaining and the finishing problem),这与我的问题类似,但并没有真正回答 - 但无论如何,我希望这不是一个重复的问题。
我在做什么:
我已经在一个方法调用的现有日志框架上创建了一个流畅的接口作为一个外观 - 所以我的语法看起来有点像这样:
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!");
这意味着什么都没有记录,虽然粗略地看起来应该是这样。
我的问题
我想知道的是 - 有人能想到另一种验证最终方法总是被调用的方法吗?在开发过程中只需要这些消息,以向开发人员强调方法链尚未完成 - 我不希望最终用户找到与登录最终产品相关的错误消息。
答案 0 :(得分:11)
首先,我会质疑在这种情况下需要一个流畅的界面,似乎你可以通过一个更简单的界面轻松过关:
Logger.Debug.Message("Test");
甚至只是:
Logger.Debug("Test");
但是,如果你真的需要/想要一个流畅的界面,另一种方法是使fluent接口处理方法的参数,而不是返回值。
所以不要这样做:
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"));