在js中动态给出
在某种情况下,例如在websocket子中,我们根据js收到的websocket状态变化等向用户进行本地化显示,也就是说本地化不是在一开始render的时候进行的,而是在js中动态给出。小例子中infoMessage是在某个Area中增加信息。var infoMessage = function(m) {
chatLog.append($('<div>').addClass('informational').text(moment().format('h:mm:ss a') + ': ' + m));
};
<!-- 例子1:无参数的本地化情况 -->
infoMessage('<spring:message code="message.chat.connecting" javaScriptEscape="true" />');
<!-- 例子2:带参数的本地化情况:通过replace进行替换 -->
infoMessage('<spring:message code="message.chat.joined" javaScriptEscape="true"/>'.replace('{0}', message.user));
一个在websocket中的例子
在websocket对话的例子中,server除了向client转发用户的对话内容,也会向client发送一些信息,例如你加入了那个会话室,有谁加入会话,有谁推出会话,这些信息是通过websocket发送的,我们希望能对这部分信息进行本地化,需要:
- 在websocket握手过程中获取用户的locale,以便在后面进行本地化
- 这不是必要的,可以有其他的方式,但却很有趣
- 将本地化中的信息代码contentCode,相关的参数contentArgument,也放在ChatMessage中,而ChatMessage在websocket中以json二进制的方式传递。需要告知websocket的decoder,这两项不要放入json中。(当然你可以全局都是@JsonIgnore,但假如只是websocket的decoder不需要)
- 在消息中放入content和localizedContent,如果是通知类的消息,将本地化后,写入content,如果是用户之间的对话,将放入content,无需本地化。
ObjectMapper中屏蔽某些json信息
我们先看看websocket传递的消息ChatMessage,支持clone。public class ChatMessage implements Cloneable{
private Instant timestamp;
private Type type;
private String user;
private String contentCode; //这是本地化所需,我们希望在websocket的json decoder中不处理这信息
private Object[] contentArguments; //这是本地化所需,我们希望在websocket的json decoder中不处理这信息
private String localizedContent;
private String userContent;
//...getters and setters
@Override
@SuppressWarnings("CloneDoesntDeclareCloneNotSupportedException")
protected ChatMessage clone() {
try {
return (ChatMessage)super.clone();
} catch (CloneNotSupportedException e) {
throw new RuntimeException("Impossible clone not supported.", e);
}
}
/* 对于webSocket中,我们希望在websocket的json decoder中不处理这信息contentCode和contentArguments。
* 也就是希望怎对websocket的decoder,在这四个getter和setter中加上@JsonIgnore
* 我们先定义一个抽象类,在后面在websocket的decoder时这些方法增加annotation @JsonIgnore */
static abstract class MixInForWebSocket
{
@JsonIgnore public abstract String getContentCode();
@JsonIgnore public abstract void setContentCode(String c);
@JsonIgnore public abstract Object[] getContentArguments();
@JsonIgnore public abstract void setContentArguments(Object... c);
}
/* 我们希望在log中屏蔽掉localizedContent(和websocket中传递消息屏蔽的不一样,所以不能用全局的@JsonIgnore)
* 我们同样也定义一个抽象类 */
static abstract class MixInForLogWrite
{
@JsonIgnore public abstract String getLocalizedContent();
@JsonIgnore public abstract void setLocalizedContent(String l);
}
}
在进行chat服务的DefaultChatService中我们将记录通话的log,这里我们希望屏蔽localizedContent。
@Service
public class DefaultChatService implements ChatService{
@Inject ObjectMapper objectMapper;
//【学习1】对于spring,支持@PostConstruct标记,表明在构造后执行。另一个比较常用的是@PreDestroy
@PostConstruct
public void initialize(){
/* 下面是javadoc的说明,我们要注意到,这里使用的objectMapper Bean,Bean是全局唯一的。
* Method to use for adding mix-in annotations to use for augmenting specified class or interface.
* All annotations from mixinSource are taken to override annotations
* that target (or its supertypes) has.
* Parameters:
* target Class (or interface) whose annotations to effectively override
* mixinSource Class (or interface) whose annotations are to be "added" to target's annotations,
* overriding as necessary
* */
this.objectMapper.addMixIn(ChatMessage.class, ChatMessage.MixInForLogWrite.class);
}
}
我们再看看websocket的decoder
@ServerEndpoint(value = "/chat/{sessionId}",
encoders = ChatMessageCodec.class,
decoders = ChatMessageCodec.class,
configurator = ChatEndpoint.EndpointConfigurator.class)
public class ChatEndpoint {
... ...
}
public class ChatMessageCodec implements Encoder.BinaryStream<ChatMessage>,Decoder.BinaryStream<ChatMessage>{
//这里没有使用bean,是另一个json解析器或封装器。ChatMessageCodec不属于spring框架,不能使用bean。
private static final ObjectMapper MAPPER = new ObjectMapper();
static {
MAPPER.findAndRegisterModules();
MAPPER.configure(JsonGenerator.Feature.AUTO_CLOSE_TARGET, false);
//同样的,通过addMinIn(),告知这个解析器Ignore相关的信息
MAPPER.addMixIn(ChatMessage.class,ChatMessage.MixInForWebSocket.class);
}
}
在webscoket的握手阶段获取locale
websocket的握手阶段是HTTP,可以在此获取locale并存放在websocket session的properties中。@ServerEndpoint(value = "/chat/{sessionId}",
encoders = ChatMessageCodec.class,
decoders = ChatMessageCodec.class,
configurator = ChatEndpoint.EndpointConfigurator.class)
public class ChatEndpoint {
... ...
public static class EndpointConfigurator extends SpringConfigurator/*ServerEndpointConfig.Configurator*/{
private static final String LOCALE_KEY = "com.wrox.ws.user.locale";
@Override
public void modifyHandshake(ServerEndpointConfig config, HandshakeRequest request, HandshakeResponse response) {
super.modifyHandshake(config, request, response);
... ...
config.getUserProperties().put(LOCALE_KEY, LocaleContextHolder.getLocale());
}
private static Locale getExposedLocale(Session session){ //增加一个静态方法方便读取
return (Locale) session.getUserProperties().get(LOCALE_KEY);
}
}
}
websocket发送带有本地化信息的消息
session.getBasicRemote().sendObject(this.cloneAndLocalize(result.getCreateMessage(),this.locale));
private ChatMessage cloneAndLocalize(ChatMessage message, Locale locale){
message = message.clone();
message.setLocalizedContent(
this.messageSource.getMessage(message.getContentCode(), message.getContentArguments(), locale));
return message;
}
相应的在js中,如果content有内容显示content,无则显示localizedContent。
相关文章相关链接: 我的Professional Java for Web Applications相关文章