是否可以在运行时添加YAWS appmods配置?

时间:2016-11-16 04:09:07

标签: erlang yaws

我在生产环境中的应用程序中嵌入了YAWS,并使用函数yaws:start_embedded/4启动YAWS。

以下是我的代码:

Id = "my_server",
GconfList = [{logdir, "./log"}, {id, Id}],  
SconfList = [{docroot, Docroot},
  {port, Port},
  {listen, Listen},
  {appmods, [      
    {"/rest", mod_rest, []},
    {"/file", mod_file, []}      
  ]}
],
yaws:start_embedded(Docroot, SconfList, GconfList, Id).

我想添加另一个appmod,例如:{"/upload", mod_upload, []}

是否可以在运行时添加appmod而无需重新启动YAWS?

1 个答案:

答案 0 :(得分:5)

您可以在运行时添加appmod,方法是首先检索当前配置,使用它创建包含新appmods的新配置,然后设置新配置。

  1. 调用yaws_api:getconf/0获取3元组{ok, GlobalConf, ServerConfs},其中GlobalConf是全局Yaws配置,ServerConfs是Yaws服务器配置列表的列表。全局conf是名为gconf的记录类型,服务器conf是名为sconf的记录类型;这两种记录类型都在yaws.hrl头文件中定义。
  2. 完成服务器配置,找到包含您要更改的appmod的配置。这有点棘手,因为您正在处理列表列表,并且您需要保持整体数据结构的形状不变。
  3. 找到sconf后,通过将新的appmod添加到其当前的appmod列表中,从中创建一个新的sconf实例。 appmod列表的每个元素都是一个元组,由appmod的URL路径和appmod模块的名称组成。 appmod元组还可以选择性地包含第三个字段,该第三个字段由要排除的第一个路径下的路径列表组成;有关详细信息,请参阅the Yaws appmod documentationexclude_paths的说明。
  4. sconf中现有的ServerConfs值替换为新值。
  5. 调用yaws_api:setconf/2设置新配置,将现有GlobalConf作为第一个参数,将包含新ServerConfs的新sconf作为第二个参数。
  6. 下面的am_extend模块显示了如何执行此操作。它导出一个add/1函数,该函数可以识别和扩充​​您关注的特定服务器中的appmod。

    -module(am_extend).
    -export([add/1]).
    
    add(AppmodAdder) ->
        {ok, GlobalConf, ServerConfs} = yaws_api:getconf(),
        NewServerConfs = add_appmod(ServerConfs, AppmodAdder),
        yaws_api:setconf(GlobalConf, NewServerConfs).
    
    add_appmod(ServerConfs, AppmodAdder) ->
        lists:foldl(fun(Val, Acc) ->
                            Acc ++ [AppmodAdder(A) || A <- Val]
                    end, [], ServerConfs).
    

    使用此代码的一个示例是将以下函数作为AppmodAdder的{​​{1}}参数传递。对于此示例,我们正在寻找具有appmod路径am_extend:add/1的服务器,以便我们可以为路径"/sse"添加另一个appmod到该服务器。我们不关心的任何服务器配置都会保持不变。

    "/sse2"

    请注意,我们的-include_lib("yaws/include/yaws.hrl"). add_sse2(#sconf{appmods=AM}=SC) -> case lists:keyfind("/sse", 1, AM) of false -> SC; _ -> SC#sconf{appmods=[{"/sse2", my_sse_module}|AM]} end. 函数必须使用add_sse2/1编译,因此它具有yaws.hrl记录的定义。