Как установить параметры конфигурации в библиотеке clojure?

Question

Я пишу библиотеку Clojure, и мне интересно, что лучше всего подходит для настройки параметров конфигурации библиотеки.

Многие библиотеки (например, в clojure-contrib) используют глобальный параметр уровня, например *buffer-size*, который пользователь может установить, позвонив по телефону set!. Но для меня это не лучший способ создать глобальное состояние, и есть вероятность столкновения имен.

Другой способ - передать параметры в каждом вызове функции, который зависит от них. Если есть много параметров, тогда их можно использовать вместо передачи отдельных.

В качестве примера предположим, что я пишу библиотеку кеша.

Используя первый подход у меня есть глобальные параметры, такие как *cache-size*, *expiry-time*, *cache-dir* и т.д. Пользователь set! с этим (или нет, и пусть они будут по умолчанию) и вызывают функцию, как (set-in-cache id obj) и (get-from-cache id).

Используя второй подход, пользователь сначала создать карту параметров и передает его на каждый звонок

(def cache-parameters {:cache-size 1000 
         :expiry-time: 1440 
         :cache-dir "c:\\cache"}) 
(set-in-cache cache-parameters id obj) 
(get-from-cache cache-parameters id) 

Итак, какой способ является предпочтительным способом в Clojure и почему?

Answer 1

На самом деле вы можете не set! вещи, как c.c.io «s *buffer-size* если вы установите поток локального связывания их с binding, with-bindings и т.д. Там просто несколько Варс, для которых резьба локального крепления устанавливаются ниже уровня Clojure машин, такие как *warn-on-reflection* и *read-eval*, что делает их set! -доступными на верхнем уровне; определяемые пользователем Vars не являются set! -able на верхнем уровне. Корневое связывание Var может быть изменено, например, alter-var-root, intern, def, .bindRoot ..., но это следует использовать экономно.

Что касается перезаписываемых Vars против явных параметров, то часть вопроса: переход с явными параметрами почти всегда в порядке и обычно предпочтительнее только из-за повышенной ремонтопригодности функций, которые четко отображают все части данных, от которых они зависят. При этом, если некоторая часть конфигурации, вероятно, будет установлена ​​один раз, а затем будет использоваться практически каждый вызов функции в приложении/библиотеке после этого, это может сделать для более чистого кода, чтобы определить Earmuffed Var, хорошо документировать его и поместить конфигурацию в нем (и это может быть одним из редких случаев, когда изменение привязки корня Var за пределами формы, которая определяет, может быть в порядке).

Подводя итог, используйте свое мнение, если вы не уверены - ошибаетесь на стороне передачи явного параметра.